SqlConnection.ChangePassword Methode

Definitie

Naamruimte:
System.Data.SqlClient
Assembly:
System.Data.dll

Hiermee wijzigt u het SQL Server wachtwoord.

Overloads

Name Description
ChangePassword(String, SqlCredential, SecureString)

Hiermee wijzigt u het SQL Server-wachtwoord voor de gebruiker die is aangegeven in het object SqlCredential.
ChangePassword(String, String)

Hiermee wijzigt u het SQL Server wachtwoord voor de gebruiker die in de verbindingsreeks is opgegeven in het opgegeven nieuwe wachtwoord.

ChangePassword(String, SqlCredential, SecureString)

Hiermee wijzigt u het SQL Server-wachtwoord voor de gebruiker die is aangegeven in het object SqlCredential.

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)

Parameters

connectionString
String

De verbindingsreeks die voldoende informatie bevat om verbinding te maken met een server. De verbindingsreeks mag geen van de volgende verbindingsreeks trefwoorden gebruiken: Integrated Security = true, UserId of Password; of ContextConnection = true.

credential
SqlCredential

Een SqlCredential-object.

newPasswordnewSecurePassword
SecureString

Het nieuwe wachtwoord. newPassword mag alleen-lezen zijn. Het wachtwoord moet ook voldoen aan een wachtwoordbeveiligingsbeleid dat is ingesteld op de server (bijvoorbeeld minimale lengte en vereisten voor specifieke tekens).

Uitzonderingen

ArgumentException

De verbindingsreeks bevat een combinatie van UserId, Password of Integrated Security=true.

– of –

De verbindingsreeks bevat Context Connection=true.

– of –

newSecurePassword (of newPassword) is groter dan 128 tekens.

– of –

newSecurePassword (of newPassword) is niet alleen-lezen.

– of –

newSecurePassword (of newPassword) is een lege tekenreeks.

ArgumentNullException

Een van de parameters (connectionString, credentialof newSecurePassword) is null.

Zie ook

Van toepassing op

ChangePassword(String, String)

Hiermee wijzigt u het SQL Server wachtwoord voor de gebruiker die in de verbindingsreeks is opgegeven in het opgegeven nieuwe wachtwoord.

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)

Parameters

connectionString
String

De verbindingsreeks die voldoende informatie bevat om verbinding te maken met de gewenste server. De verbindingsreeks moet de gebruikers-id en het huidige wachtwoord bevatten.

newPassword
String

Het nieuwe wachtwoord dat moet worden ingesteld. Dit wachtwoord moet voldoen aan een wachtwoordbeveiligingsbeleid dat is ingesteld op de server, inclusief minimale lengte, vereisten voor specifieke tekens, enzovoort.

Uitzonderingen

ArgumentException

De verbindingsreeks bevat de optie om geïntegreerde beveiliging te gebruiken.

Or

De newPassword waarde overschrijdt 128 tekens.

ArgumentNullException

connectionString De parameter of de newPassword parameter is null.

Opmerkingen

Wanneer u SQL Server op Windows Server gebruikt, kunt u profiteren van functionaliteit waarmee de clienttoepassing zowel het huidige als een nieuw wachtwoord kan leveren om het bestaande wachtwoord te wijzigen. Toepassingen kunnen functionaliteit implementeren, zoals het vragen van de gebruiker om een nieuw wachtwoord tijdens de eerste aanmelding als de oude is verlopen en deze bewerking kan worden voltooid zonder tussenkomst van de beheerder.

Warning

Microsoft raadt u niet aan om uw gebruikersnaam en wachtwoord rechtstreeks op te geven, omdat dit een onveilig patroon is. Gebruik waar mogelijk veiligere verificatiestromen, zoals Beheerde identiteiten voor Azure resources of Windows authentication voor SQL Server.

De methode ChangePassword wijzigt het SQL Server-wachtwoord voor de gebruiker die is opgegeven in de opgegeven parameter connectionString in de waarde die is opgegeven in de parameter newPassword. Als de verbindingsreeks de optie voor geïntegreerde beveiliging bevat (dat wil bijvoorbeeld "Integrated Security=True" of het equivalent), wordt er een uitzondering gegenereerd.

Als u wilt bepalen dat het wachtwoord is verlopen, wordt door het aanroepen van de Open methode een SqlException. Om aan te geven dat het wachtwoord dat zich in de verbindingsreeks bevindt, opnieuw moet worden ingesteld, bevat de eigenschap Number voor de uitzondering de statuswaarde 18487 of 18488. De eerste waarde (18487) geeft aan dat het wachtwoord is verlopen en de tweede (18488) geeft aan dat het wachtwoord opnieuw moet worden ingesteld voordat u zich aanmeldt.

Deze methode opent een eigen verbinding met de server, vraagt de wachtwoordwijziging aan en sluit de verbinding zodra deze is voltooid. Deze verbinding wordt niet opgehaald uit of geretourneerd naar de SQL Server verbindingsgroep.

Zie ook

Van toepassing op