SqlConnection.ChangePassword Metoda

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Przeciążenia

ChangePassword(String, SqlCredential, SecureString)	Zmienia hasło SQL Server dla użytkownika wskazanego SqlCredential w obiekcie.
ChangePassword(String, String)	Zmienia hasło SQL Server użytkownika wskazane w parametry połączenia do podanego nowego hasła.

ChangePassword(String, SqlCredential, SecureString)

Zmienia hasło SQL Server dla użytkownika wskazanego SqlCredential w obiekcie.

public:
 static void ChangePassword(System::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 newSecurePassword);

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)

Parametry

connectionString

String

Parametry połączenia, który zawiera wystarczające informacje, aby nawiązać połączenie z serwerem. Parametry połączenia nie powinien używać żadnego z następujących słów kluczowych parametry połączenia: Integrated Security = true, lub UserIdPasswordlub ContextConnection = true.

credential

SqlCredential

Obiekt SqlCredential.

newSecurePassword

SecureString

Nowe hasło. newSecurePassword musi być tylko do odczytu. Hasło musi być również zgodne z wszelkimi zasadami zabezpieczeń haseł ustawionymi na serwerze (na przykład minimalną długość i wymagania dotyczące określonych znaków).

Wyjątki

ArgumentException

Parametry połączenia zawiera dowolną kombinację UserId, Passwordlub Integrated Security=true.

-lub-

newSecurePassword jest większa niż 128 znaków.

-lub-

newSecurePassword nie jest tylko do odczytu.

-lub-

newSecurePassword jest pustym ciągiem.

ArgumentNullException

Jeden z parametrów (connectionString, credentiallub newSecurePassword) ma wartość null.

ChangePassword(String, String)

Zmienia hasło SQL Server użytkownika wskazane w parametry połączenia do podanego nowego hasła.

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)

Parametry

connectionString

String

Parametry połączenia, który zawiera wystarczające informacje, aby nawiązać połączenie z żądanym serwerem. Parametry połączenia musi zawierać identyfikator użytkownika i bieżące hasło.

newPassword

String

Nowe hasło do ustawienia. To hasło musi być zgodne z wszelkimi zasadami zabezpieczeń haseł ustawionymi na serwerze, w tym minimalną długość, wymagania dotyczące określonych znaków itd.

Wyjątki

ArgumentException

Parametry połączenia obejmuje opcję korzystania ze zintegrowanych zabezpieczeń.

Lub

Przekracza newPassword 128 znaków.

ArgumentNullException

Parametr connectionString lub newPassword ma wartość null.

Przykłady

Poniżej przedstawiono prosty przykład zmiany hasł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  

Poniższa aplikacja konsolowa demonstruje problemy związane ze zmianą hasła użytkownika, ponieważ bieżące hasło wygasło.

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

Uwagi

Jeśli używasz SQL Server w systemie Windows Server, deweloperzy mogą korzystać z funkcji, która umożliwia aplikacji klienckiej podanie zarówno bieżącego, jak i nowego hasła w celu zmiany istniejącego hasła. Aplikacje mogą implementować funkcje, takie jak monitowanie użytkownika o nowe hasło podczas początkowego logowania, jeśli stary wygasł, i tę operację można wykonać bez interwencji administratora.

Metoda ChangePassword zmienia hasło SQL Server dla użytkownika wskazanego w podanym connectionString parametrze na wartość podaną w parametrze newPassword . Jeśli parametry połączenia zawiera opcję zintegrowanych zabezpieczeń (czyli "Integrated Security=True" lub odpowiednik), zgłaszany jest wyjątek.

Aby ustalić, czy hasło wygasło, wywołanie Open metody wywołuje metodę SqlException. Aby wskazać, że hasło zawarte w parametry połączenia musi zostać zresetowane, Number właściwość wyjątku zawiera wartość stanu 18487 lub 18488. Pierwsza wartość (18487) wskazuje, że hasło wygasło, a drugi (18488) wskazuje, że hasło musi zostać zresetowane przed zalogowaniem.

Ta metoda otwiera własne połączenie z serwerem, żąda zmiany hasła i zamyka połączenie zaraz po zakończeniu. To połączenie nie jest pobierane ani zwracane do puli połączeń SQL Server.