SqlConnection.ChangePassword Yöntem

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.dll

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

Aşırı Yüklemeler

Name	Description
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ı belirtilen yeni parolayla değiştirir.

ChangePassword(String, SqlCredential, SecureString)

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 ^ newSecurePassword);

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

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.

newSecurePassword

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.

• ADO.NET Genel Bakış

ChangePassword(String, String)

Bağlantı dizesinde belirtilen kullanıcının SQL Server parolasını belirtilen 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.

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.

• Bağlantı Dizeleri (ADO.NET)
• Veri Kaynağına Bağlanma (ADO.NET)
• SQL Server için .NET Framework Veri Sağlayıcısını Kullanma
• ADO.NET Genel Bakış