SqlConnection.ChangePassword Methode

Quelle:

SqlConnection.cs

Quelle:

SqlConnection.cs

Quelle:

SqlConnection.cs

Quelle:

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)

Parameter

Ausnahmen

Quelle:

SqlConnection.cs

Quelle:

SqlConnection.cs

Quelle:

SqlConnection.cs

Quelle:

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)

Parameter

Ausnahmen

Beispiele

Im Folgenden sehen Sie ein einfaches Beispiel zum Ändern eines Kennworts:

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

Die folgende Konsolenanwendung veranschaulicht die Probleme beim Ändern des Kennworts eines Benutzers, da das aktuelle Kennwort abgelaufen ist.

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;
    }
}

Hinweise

Wenn Sie SQL Server für Windows Server verwenden, können Entwickler funktionen nutzen, mit denen die Clientanwendung sowohl das aktuelle als auch ein neues Kennwort bereitstellen kann, um das vorhandene Kennwort zu ändern. Anwendungen können Funktionen implementieren, z. B. die Aufforderung des Benutzers zur Eingabe eines neuen Kennworts während der ersten Anmeldung, wenn der alte abgelaufen ist, und dieser Vorgang kann ohne Administratoreingriff abgeschlossen werden. Diese Methode ändert das SQL Server Kennwort für den im angegebenen Parameter angegebenen connectionString Parameter in den im newPassword Parameter angegebenen Wert. Wenn die Verbindungszeichenfolge die Option für integrierte Sicherheit (d. h. "Integrated Security=True" oder die entsprechende) enthält, wird eine Ausnahme ausgelöst. Um zu ermitteln, dass das Kennwort abgelaufen ist, löst das Aufrufen der Open()-Methode eine SqlExceptionaus. Um anzugeben, dass das Kennwort, das in der Verbindungszeichenfolge enthalten ist, zurückgesetzt werden muss, enthält die Number Eigenschaft für die Ausnahme den Statuswert 18487 oder 18488. Der erste Wert (18487) gibt an, dass das Kennwort abgelaufen ist und die zweite (18488) angibt, dass das Kennwort zurückgesetzt werden muss, bevor sie sich anmelden. Diese Methode öffnet eine eigene Verbindung mit dem Server, fordert die Kennwortänderung an und schließt die Verbindung, sobald sie abgeschlossen ist. Diese Verbindung wird nicht aus dem SQL Server Verbindungspool abgerufen oder zurückgegeben.