Condividi tramite

SqlConnection.ChangePassword Metodo

Definizione

Spazio dei nomi:
System.Data.SqlClient
Assembly:
System.Data.dll

Modifica la password di SQL Server.

Overload

Nome Descrizione
ChangePassword(String, SqlCredential, SecureString)

Modifica la password di SQL Server per l'utente indicato nell'oggetto SqlCredential.
ChangePassword(String, String)

Modifica la password di SQL Server per l'utente indicato nella stringa di connessione alla nuova password specificata.

ChangePassword(String, SqlCredential, SecureString)

Origine:
System.Data.SqlClient.notsupported.cs

Modifica la password di SQL Server per l'utente indicato nell'oggetto 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)

Parametri

connectionString
String

Stringa di connessione contenente informazioni sufficienti per connettersi a un server. La stringa di connessione non deve usare una delle parole chiave della stringa di connessione seguenti: Integrated Security = true, UserIdo Password; o ContextConnection = true.

credential
SqlCredential

Oggetto SqlCredential.

newPasswordnewSecurePassword
SecureString

Nuova password. newPassword deve essere di sola lettura. La password deve inoltre essere conforme ai criteri di sicurezza delle password impostati nel server ( ad esempio, lunghezza minima e requisiti per caratteri specifici).

Eccezioni

ArgumentException

La stringa di connessione contiene qualsiasi combinazione di UserId, Passwordo Integrated Security=true.

-o-

La stringa di connessione contiene Context Connection=true.

-o-

newSecurePassword (o newPassword) è maggiore di 128 caratteri.

-o-

newSecurePassword (o newPassword) non è di sola lettura.

-o-

newSecurePassword (o newPassword) è una stringa vuota.

ArgumentNullException

Uno dei parametri (connectionString, credentialo newSecurePassword) è Null.

Vedi anche

Si applica a

ChangePassword(String, String)

Origine:
System.Data.SqlClient.notsupported.cs

Modifica la password di SQL Server per l'utente indicato nella stringa di connessione alla nuova password specificata.

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)

Parametri

connectionString
String

Stringa di connessione contenente informazioni sufficienti per connettersi al server desiderato. La stringa di connessione deve contenere l'ID utente e la password corrente.

newPassword
String

Nuova password da impostare. Questa password deve essere conforme ai criteri di sicurezza delle password impostati nel server, tra cui lunghezza minima, requisiti per caratteri specifici e così via.

Eccezioni

ArgumentException

La stringa di connessione include l'opzione per l'uso della sicurezza integrata.

O

Il newPassword supera i 128 caratteri.

ArgumentNullException

Il connectionString o il parametro newPassword è Null.

Commenti

Quando si usa SQL Server in Windows Server, è possibile sfruttare le funzionalità che consentono all'applicazione client di fornire sia la password corrente che quella nuova per modificare la password esistente. Le applicazioni possono implementare funzionalità come la richiesta all'utente di una nuova password durante l'accesso iniziale se quella precedente è scaduta e questa operazione può essere completata senza l'intervento dell'amministratore.

Avvertimento

Microsoft non consiglia di fornire direttamente il nome utente e la password, perché si tratta di un modello non sicuro. Se possibile, usare flussi di autenticazione più sicuri, ad esempio identità gestite per le risorse di Azureo l'autenticazione di Windows per SQL Server.

Il metodo ChangePassword modifica la password di SQL Server per l'utente indicato nel parametro connectionString fornito al valore fornito nel parametro newPassword. Se la stringa di connessione include l'opzione per la sicurezza integrata, ovvero "Integrated Security=True" o equivalente, viene generata un'eccezione.

Per determinare che la password è scaduta, la chiamata al metodo Open genera un SqlException. Per indicare che la password contenuta nella stringa di connessione deve essere reimpostata, la proprietà Number per l'eccezione contiene il valore di stato 18487 o 18488. Il primo valore (18487) indica che la password è scaduta e la seconda (18488) indica che la password deve essere reimpostata prima dell'accesso.

Questo metodo apre la propria connessione al server, richiede la modifica della password e chiude la connessione non appena è stata completata. Questa connessione non viene recuperata o restituita al pool di connessioni di SQL Server.

Vedi anche

Si applica a