SqlConnection.ChangePassword Metod

Definition

Namnområde:
System.Data.SqlClient
Sammansättning:
System.Data.dll

Ändrar lösenordet för SQL Server.

Överlagringar

Name Description
ChangePassword(String, SqlCredential, SecureString)

Ändrar SQL Server lösenord för användaren som anges i objektet SqlCredential.
ChangePassword(String, String)

Ändrar SQL Server lösenord för användaren som anges i reťazec pripojenia till det angivna nya lösenordet.

ChangePassword(String, SqlCredential, SecureString)

Källa:
System.Data.SqlClient.notsupported.cs

Ändrar SQL Server lösenord för användaren som anges i objektet 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)

Parametrar

connectionString
String

Den reťazec pripojenia som innehåller tillräckligt med information för att ansluta till en server. Connection string bör inte använda något av följande reťazec pripojenia nyckelord: Integrated Security = true, UserId eller Password; eller ContextConnection = true.

credential
SqlCredential

Ett SqlCredential objekt.

newPasswordnewSecurePassword
SecureString

Det nya lösenordet. newPassword måste vara skrivskyddad. Lösenordet måste också uppfylla alla lösenordssäkerhetsprinciper som angetts på servern (till exempel minsta längd och krav för specifika tecken).

Undantag

ArgumentException

reťazec pripojenia innehåller valfri kombination av UserId, Password eller Integrated Security=true.

-eller-

Connection string innehåller Context Connection=true.

-eller-

newSecurePassword (eller newPassword) är större än 128 tecken.

-eller-

newSecurePassword (eller newPassword) är inte skrivskyddad.

-eller-

newSecurePassword (eller newPassword) är en tom sträng.

ArgumentNullException

En av parametrarna (connectionString, credential, eller newSecurePassword) är null.

Se även

Gäller för

ChangePassword(String, String)

Källa:
System.Data.SqlClient.notsupported.cs

Ändrar SQL Server lösenord för användaren som anges i reťazec pripojenia till det angivna nya lösenordet.

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)

Parametrar

connectionString
String

Den reťazec pripojenia som innehåller tillräckligt med information för att ansluta till den server som du vill ha. Connection string måste innehålla användar-ID:t och det aktuella lösenordet.

newPassword
String

Det nya lösenordet som ska anges. Det här lösenordet måste uppfylla alla lösenordssäkerhetsprinciper som angetts på servern, inklusive minsta längd, krav för specifika tecken och så vidare.

Undantag

ArgumentException

Connection string innehåller alternativet att använda integrerad säkerhet.

Eller

Överskrider newPassword 128 tecken.

ArgumentNullException

Antingen är parametern connectionStringnewPassword eller null.

Kommentarer

När du använder SQL Server på Windows Server kan du dra nytta av funktioner som gör att klientprogrammet kan ange både det aktuella och ett nytt lösenord för att ändra det befintliga lösenordet. Program kan implementera funktioner som att fråga användaren om ett nytt lösenord under den första inloggningen om den gamla har upphört att gälla, och den här åtgärden kan slutföras utan administratörsintervention.

Varning

Microsoft rekommenderar inte att du anger ditt användarnamn och lösenord direkt, eftersom det är ett osäkert mönster. Använd om möjligt säkrare autentiseringsflöden, till exempel Hanterade identiteter för Azure resurser eller Windows authentication för SQL Server.

Metoden ChangePassword ändrar SQL Server lösenordet för användaren som anges i den angivna parametern connectionString till det värde som anges i parametern newPassword. Om reťazec pripojenia innehåller alternativet för integrerad säkerhet (dvs. "Integrated Security=True" eller motsvarande) genereras ett undantag.

För att fastställa att lösenordet har upphört att gälla genererar anropet av Open metoden en SqlException. För att ange att lösenordet som finns i reťazec pripojenia måste återställas innehåller egenskapen Number för undantaget statusvärdet 18487 eller 18488. Det första värdet (18487) anger att lösenordet har upphört att gälla och det andra (18488) anger att lösenordet måste återställas innan du loggar in.

Den här metoden öppnar en egen anslutning till servern, begär lösenordsändringen och stänger anslutningen så snart den har slutförts. Den här anslutningen hämtas inte från eller returneras till SQL Server anslutningspoolen.

Se även

Gäller för