Freigeben über

SqlConnection.ChangePassword Methode

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.dll

Ändert das SQL Server-Kennwort.

Überlädt

Name Beschreibung
ChangePassword(String, SqlCredential, SecureString)

Ändert das SQL Server-Kennwort für den im SqlCredential-Objekt angegebenen Benutzer.
ChangePassword(String, String)

Ändert das SQL Server-Kennwort für den Benutzer, der in der Verbindungszeichenfolge angegeben ist, in das angegebene neue Kennwort.

ChangePassword(String, SqlCredential, SecureString)

Quelle:
System.Data.SqlClient.notsupported.cs

Ändert das SQL Server-Kennwort für den im SqlCredential-Objekt angegebenen Benutzer.

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)

Parameter

connectionString
String

Die Verbindungszeichenfolge, die genügend Informationen enthält, um eine Verbindung mit einem Server herzustellen. Die Verbindungszeichenfolge sollte keines der folgenden Verbindungszeichenfolgenstichwörter verwenden: Integrated Security = true, UserIdoder Password; oder ContextConnection = true.

credential
SqlCredential

Ein SqlCredential-Objekt.

newPasswordnewSecurePassword
SecureString

Das neue Kennwort. newPassword darf schreibgeschützt sein. Das Kennwort muss auch allen auf dem Server festgelegten Kennwortsicherheitsrichtlinien entsprechen (z. B. Mindestlänge und Anforderungen für bestimmte Zeichen).

Ausnahmen

ArgumentException

Die Verbindungszeichenfolge enthält eine beliebige Kombination aus UserId, Passwordoder Integrated Security=true.

-oder-

Die Verbindungszeichenfolge enthält Context Connection=true.

-oder-

newSecurePassword (oder newPassword) ist größer als 128 Zeichen.

-oder-

newSecurePassword (oder newPassword) ist nicht schreibgeschützt.

-oder-

newSecurePassword (oder newPassword) ist eine leere Zeichenfolge.

ArgumentNullException

Einer der Parameter (connectionString, credentialoder newSecurePassword) ist NULL.

Weitere Informationen

Gilt für:

ChangePassword(String, String)

Quelle:
System.Data.SqlClient.notsupported.cs

Ändert das SQL Server-Kennwort für den Benutzer, der in der Verbindungszeichenfolge angegeben ist, in das angegebene neue Kennwort.

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

connectionString
String

Die Verbindungszeichenfolge, die genügend Informationen enthält, um eine Verbindung mit dem gewünschten Server herzustellen. Die Verbindungszeichenfolge muss die Benutzer-ID und das aktuelle Kennwort enthalten.

newPassword
String

Das neue festzulegende Kennwort. Dieses Kennwort muss allen auf dem Server festgelegten Kennwortsicherheitsrichtlinien entsprechen, einschließlich der Mindestlänge, der Anforderungen für bestimmte Zeichen usw.

Ausnahmen

ArgumentException

Die Verbindungszeichenfolge enthält die Option zur Verwendung der integrierten Sicherheit.

Oder

Die newPassword überschreitet 128 Zeichen.

ArgumentNullException

Der connectionString oder der parameter newPassword ist null.

Hinweise

Wenn Sie SQL Server unter Windows Server verwenden, können Sie die 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.

Warnung

Microsoft empfiehlt nicht, Ihren Benutzernamen und Ihr Kennwort direkt anzugeben, da es sich um ein unsicheres Muster handelt. Verwenden Sie nach Möglichkeit sicherere Authentifizierungsflüsse, z. B. verwaltete Identitäten für Azure-Ressourcen, oder Windows-Authentifizierungs- für SQL Server.

Die ChangePassword Methode ändert das SQL Server-Kennwort für den benutzer, der im angegebenen connectionString Parameter angegeben ist, in den wert, der im parameter newPassword angegeben ist. 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.

Weitere Informationen

Gilt für: