SqlConnection.ChangePassword Método

Source:

SqlConnection.cs

Source:

SqlConnection.cs

Source:

SqlConnection.cs

Source:

SqlConnection.cs

public:
 static void ChangePassword(System::String ^ connectionString, Microsoft::Data::SqlClient::SqlCredential ^ credential, System::Security::SecureString ^ newSecurePassword);

public:
 static void ChangePassword(System::String ^ connectionString, Microsoft::Data::SqlClient::SqlCredential ^ credential, System::Security::SecureString ^ newPassword);

public static void ChangePassword(string connectionString, Microsoft.Data.SqlClient.SqlCredential credential, System.Security.SecureString newSecurePassword);

public static void ChangePassword(string connectionString, Microsoft.Data.SqlClient.SqlCredential credential, System.Security.SecureString newPassword);

static member ChangePassword : string * Microsoft.Data.SqlClient.SqlCredential * System.Security.SecureString -> unit

static member ChangePassword : string * Microsoft.Data.SqlClient.SqlCredential * System.Security.SecureString -> unit

Public Shared Sub ChangePassword (connectionString As String, credential As SqlCredential, newSecurePassword As SecureString)

Public Shared Sub ChangePassword (connectionString As String, credential As SqlCredential, newPassword As SecureString)

Parámetros

Excepciones

Source:

SqlConnection.cs

Source:

SqlConnection.cs

Source:

SqlConnection.cs

Source:

SqlConnection.cs

public:
 static void ChangePassword(System::String ^ connectionString, System::String ^ newPassword);

public static void ChangePassword(string connectionString, string newPassword);

static member ChangePassword : string * string -> unit

Public Shared Sub ChangePassword (connectionString As String, newPassword As String)

Parámetros

Excepciones

Ejemplos

A continuación se muestra un ejemplo sencillo de cómo cambiar una contraseña:

class Program
{
  static void Main(string[] args)
  {
    Microsoft.Data.SqlClient.SqlConnection.ChangePassword(
      "Data Source=a_server;Initial Catalog=a_database;UID=user;PWD=old_password",
      "new_password");
  }
}

Module Module1
  Sub Main()
    Microsoft.Data.SqlClient.SqlConnection.ChangePassword(
      "Data Source=a_server;Initial Catalog=a_database;UID=user;PWD=old_password",
      "new_password")
  End Sub
End Module

En la siguiente aplicación de consola se muestran los problemas relacionados con el cambio de la contraseña de un usuario porque la contraseña actual ha expirado.

using System;
using System.Data;
using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            DemonstrateChangePassword();
        }
        catch (Exception ex)
        {
            Console.WriteLine("Error: " + ex.Message);
        }
        Console.WriteLine("Press ENTER to continue...");
        Console.ReadLine();
    }

    private static void DemonstrateChangePassword()
    {
        // Retrieve the connection string. In a production application,
        // this string should not be contained within the source code.
        string connectionString = GetConnectionString();

        using (SqlConnection cnn = new SqlConnection())
        {
            for (int i = 0; i <= 1; i++)
            {
                // Run this loop at most two times. If the first attempt fails, 
                // the code checks the Number property of the SqlException object.
                // If that contains the special values 18487 or 18488, the code 
                // attempts to set the user's password to a new value. 
                // Assuming this succeeds, the second pass through 
                // successfully opens the connection.
                // If not, the exception handler catches the exception.
                try
                {
                    cnn.ConnectionString = connectionString;
                    cnn.Open();
                    // Once this succeeds, just get out of the loop.
                    // No need to try again if the connection is already open.
                    break;
                }
                catch (SqlException ex)
                {
                    if (i == 0 && ((ex.Number == 18487) || (ex.Number == 18488)))
                    {
                        // You must reset the password. 
                        connectionString =
                            ModifyConnectionString(connectionString,
                            GetNewPassword());

                    }
                    else
                        // Bubble all other SqlException occurrences
                        // back up to the caller.
                        throw;
                }
            }
            SqlCommand cmd = new SqlCommand(
                "SELECT ProductID, Name FROM Product", cnn);
            // Use the connection and command here...
        }
    }

    private static string ModifyConnectionString(
        string connectionString, string NewPassword)
    {

        // Use the SqlConnectionStringBuilder class to modify the
        // password portion of the connection string. 
        SqlConnectionStringBuilder builder =
            new SqlConnectionStringBuilder(connectionString);
        builder.Password = NewPassword;
        return builder.ConnectionString;
    }

    private static string GetNewPassword()
    {
        // In a real application, you might display a modal
        // dialog box to retrieve the new password. The concepts
        // are the same as for this simple console application, however.
        Console.Write("Your password must be reset. Enter a new password: ");
        return Console.ReadLine();
    }

    private static string GetConnectionString()
    {
        // For this demonstration, the connection string must
        // contain both user and password information. In your own
        // application, you might want to retrieve this setting
        // from a config file, or from some other source.

        // In a production application, you would want to 
        // display a modal form that could gather user and password
        // information.
        SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder(
            "Data Source=(local);Initial Catalog=AdventureWorks");

        Console.Write("Enter your user id: ");
        builder.UserID = Console.ReadLine();
        Console.Write("Enter your password: ");
        builder.Password = Console.ReadLine();

        return builder.ConnectionString;
    }
}

Comentarios

Cuando usa SQL Server en Windows Server, los desarrolladores pueden aprovechar las ventajas de la funcionalidad que permite a la aplicación cliente proporcionar la contraseña actual y una nueva para cambiar la contraseña existente. Las aplicaciones pueden implementar funcionalidades como solicitar al usuario una nueva contraseña durante el inicio de sesión inicial si el anterior ha expirado y esta operación se puede completar sin intervención del administrador. Este método cambia la contraseña de SQL Server para el usuario indicado en el parámetro proporcionado connectionString al valor proporcionado en el newPassword parámetro . Si la cadena de conexión incluye la opción de seguridad integrada (es decir, "Integrated Security=True" o el equivalente), se produce una excepción. Para determinar que la contraseña ha expirado, al llamar al método Open() se genera un SqlException. Para indicar que se debe restablecer la contraseña contenida en la cadena de conexión, la propiedad Number para la excepción contiene el valor de estado 18487 o 18488. El primer valor (18487) indica que la contraseña ha expirado y la segunda (18488) indica que la contraseña debe restablecerse antes de iniciar sesión. Este método abre su propia conexión con el servidor, solicita el cambio de contraseña y cierra la conexión tan pronto como se haya completado. Esta conexión no se recupera de ni se devuelve al grupo de conexiones de SQL Server.