Aracılığıyla paylaş

SqlConnection.ChangePassword Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Data.SqlClient
Bütünleştirilmiş Kod:
System.Data.SqlClient.dll
Bütünleştirilmiş Kod:
System.Data.dll
Paket:
System.Data.SqlClient v4.9.0

SQL Server parolasını değiştirir.

Aşırı Yüklemeler

ChangePassword(String, SqlCredential, SecureString)

SqlCredential nesnesinde belirtilen kullanıcının SQL Server parolasını değiştirir.
ChangePassword(String, String)

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

ChangePassword(String, SqlCredential, SecureString)

Kaynak:
System.Data.SqlClient.notsupported.cs

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

public:
 static void ChangePassword(System::String ^ connectionString, System::Data::SqlClient::SqlCredential ^ credential, System::Security::SecureString ^ newPassword);
public:
 static void ChangePassword(System::String ^ connectionString, System::Data::SqlClient::SqlCredential ^ credential, System::Security::SecureString ^ newSecurePassword);
public static void ChangePassword (string connectionString, System.Data.SqlClient.SqlCredential credential, System.Security.SecureString newPassword);
public static void ChangePassword (string connectionString, System.Data.SqlClient.SqlCredential credential, System.Security.SecureString newSecurePassword);
static member ChangePassword : string * System.Data.SqlClient.SqlCredential * System.Security.SecureString -> unit
static member ChangePassword : string * System.Data.SqlClient.SqlCredential * System.Security.SecureString -> unit
Public Shared Sub ChangePassword (connectionString As String, credential As SqlCredential, newPassword As SecureString)
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 şu bağlantı dizesi anahtar sözcüklerinden hiçbirini kullanmamalıdır: Integrated Security = true, UserIdveya Password; veya ContextConnection = true.

credential
SqlCredential

SqlCredential nesnesi.

newPasswordnewSecurePassword
SecureString

Yeni parola. newPassword salt okunur olmalıdır. Parola, sunucuda ayarlanan tüm parola güvenlik ilkesiyle de uyumlu olmalıdır (örneğin, belirli karakterler için minimum uzunluk ve gereksinimler).

Özel durumlar

ArgumentException

Bağlantı dizesi UserId, Passwordveya Integrated Security=trueherhangi bir bileşimini içerir.

-veya-

Bağlantı dizesi Context Connection=trueiçerir.

-veya-

newSecurePassword (veya newPassword) 128 karakterden büyük.

-veya-

newSecurePassword (veya newPassword) salt okunur değildir.

-veya-

newSecurePassword (veya newPassword) boş bir dizedir.

ArgumentNullException

Parametrelerden (connectionString, credentialveya newSecurePassword) biri null.

Ayrıca bkz.

Şunlara uygulanır

ChangePassword(String, String)

Kaynak:
System.Data.SqlClient.notsupported.cs

Bağlantı dizesinde 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 ilkesiyle 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

Uyarı

Microsoft, güvenli olmayan bir desen olduğundan kullanıcı adınızı ve parolanızı doğrudan sağlamanızı önermez. Mümkün olduğunda,Azure kaynakları için Yönetilen Kimlikler veya SQL Server için Windows kimlik doğrulaması gibi daha güvenli kimlik doğrulama akışları kullanın.

Parolayı değiştirmenin basit bir örneği aşağıda verilmiştir:

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

Module Module1
    Sub Main()
System.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 System;
using System.Data;
using System.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;
    }
}

Option Explicit On
Option Strict On

Imports System.Data
Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Try
            DemonstrateChangePassword()
        Catch ex As Exception
            Console.WriteLine("Error: " & ex.Message)
        End Try
        Console.WriteLine("Press ENTER to continue...")
        Console.ReadLine()
    End Sub

    Private Sub DemonstrateChangePassword()
        Dim connectionString As String = GetConnectionString()
        Using cnn As New SqlConnection()
            For i As Integer = 0 To 1
                ' 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.
                    Exit For

                Catch ex As SqlException _
                 When (i = 0 And (ex.Number = 18487 Or ex.Number = 18488))
                    ' You must reset the password.
                    connectionString = ModifyConnectionString( _
                     connectionString, GetNewPassword())

                Catch ex As SqlException
                    ' Bubble all other SqlException occurrences
                    ' back up to the caller.
                    Throw
                End Try
            Next
            Dim cmd As New SqlCommand("SELECT ProductID, Name FROM Product", cnn)
            ' Use the connection and command here...
        End Using
    End Sub

    Private Function ModifyConnectionString( _
     ByVal connectionString As String, ByVal NewPassword As String) As String

        ' Use the SqlConnectionStringBuilder class to modify the
        ' password portion of the connection string. 
        Dim builder As New SqlConnectionStringBuilder(connectionString)
        builder.Password = NewPassword
        Return builder.ConnectionString
    End Function

    Private Function GetNewPassword() As String
        ' 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()
    End Function

    Private Function GetConnectionString() As String
        ' 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.
        Dim builder As 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
    End Function
End Module

Açıklamalar

Windows Server'da SQL Server kullanırken, 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 yararlanabilirsiniz. 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.

Uyarı

Microsoft, güvenli olmayan bir desen olduğundan kullanıcı adınızı ve parolanızı doğrudan sağlamanızı önermez. Mümkün olduğunda,Azure kaynakları için Yönetilen Kimlikler veya SQL Server için Windows kimlik doğrulaması gibi daha güvenli kimlik doğrulama akışları kullanın.

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

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

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ülür.

Ayrıca bkz.

Şunlara uygulanır