SqlConnection.ChangePassword Yöntem

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Aşırı Yüklemeler

ChangePassword(String, SqlCredential, SecureString)	Nesnede SqlCredential belirtilen kullanıcının SQL Server parolasını değiştirir.
ChangePassword(String, String)	bağlantı dizesi belirtilen kullanıcının SQL Server parolasını sağlanan yeni parolayla değiştirir.

ChangePassword(String, SqlCredential, SecureString)

Nesnede SqlCredential belirtilen kullanıcının SQL Server parolasını değiştirir.

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)

Parametreler

connectionString

String

Sunucuya bağlanmak için yeterli bilgi içeren bağlantı dizesi. bağlantı dizesi, aşağıdaki bağlantı dizesi anahtar sözcüklerinden hiçbirini kullanmamalıdır: Integrated Security = true, UserId, veya Passwordveya ContextConnection = true.

credential

SqlCredential

Bir SqlCredential nesnesi.

newSecurePassword

SecureString

Yeni parola. newSecurePassword salt okunur olmalıdır. Parolanın sunucuda ayarlanan tüm parola güvenlik ilkeleriyle de uyumlu olması gerekir (örneğin, belirli karakterler için en düşük uzunluk ve gereksinimler).

Özel durumlar

ArgumentException

bağlantı dizesi herhangi bir , Passwordveya Integrated Security=truebirleşimini UserIdiçerir.

-veya-

newSecurePassword 128 karakterden büyük.

-veya-

newSecurePassword salt okunur değildir.

-veya-

newSecurePassword boş bir dizedir.

ArgumentNullException

ParametrelerdenconnectionString (, credential, veya newSecurePassword) biri null.

ChangePassword(String, String)

bağlantı dizesi belirtilen kullanıcının SQL Server parolasını sağlanan yeni parolayla değiştirir.

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)

Parametreler

connectionString

String

İstediğiniz sunucuya bağlanmak için yeterli bilgi içeren bağlantı dizesi. bağlantı dizesi kullanıcı kimliğini ve geçerli parolayı içermelidir.

newPassword

String

Ayarlanacağı yeni parola. Bu parola, en düşük uzunluk, belirli karakterler için gereksinimler vb. dahil olmak üzere sunucuda ayarlanan tüm parola güvenlik ilkeleriyle uyumlu olmalıdır.

Özel durumlar

ArgumentException

bağlantı dizesi tümleşik güvenliği kullanma seçeneğini içerir.

Veya

newPassword 128 karakteri aşıyor.

ArgumentNullException

connectionString veya newPassword parametresi null.

Örnekler

Aşağıda, parola değiştirme işleminin basit bir örneği verilmiştir:

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  

Aşağıdaki konsol uygulaması, geçerli parolanın süresi dolduğundan kullanıcının parolasını değiştirmeyle ilgili sorunları gösterir.

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

Açıklamalar

Windows Server'da SQL Server kullanırken, geliştiriciler istemci uygulamasının mevcut parolayı değiştirmek için hem geçerli hem de yeni bir parola sağlamasına olanak tanıyan işlevlerden yararlanabilir. Uygulamalar, eskisinin süresi dolduysa ilk oturum açma sırasında kullanıcıdan yeni parola isteme gibi işlevler uygulayabilir ve bu işlem yönetici müdahalesi olmadan tamamlanabilir.

yöntemi, ChangePassword sağlanan connectionString parametrede belirtilen kullanıcının SQL Server parolasını parametresinde sağlanan değerle newPassword değiştirir. bağlantı dizesi tümleşik güvenlik seçeneğini içeriyorsa (yani, "Tümleşik Güvenlik=Doğru" veya eşdeğeri), bir özel durum oluşturulur.

Parolanın süresinin dolduğunu belirlemek için yöntemini çağırmak Open bir SqlExceptionoluşturur. bağlantı dizesi içindeki parolanın sıfırlanması gerektiğini belirtmek için, Number özel durumun özelliği 18487 veya 18488 durum değerini içerir. İlk değer (18487) parolanın süresinin dolduğunu, ikinci (18488) ise oturum açmadan önce parolanın sıfırlanması gerektiğini gösterir.

Bu yöntem sunucuyla kendi bağlantısını açar, parola değişikliğini talep eder ve tamamlanır tamamlanmaz bağlantıyı kapatır. Bu bağlantı, SQL Server bağlantı havuzundan alınmaz veya bu havuza döndürülemez.