ActiveDirectoryMembershipProvider.ChangePassword Metodo

Definizione

Spazio dei nomi:

System.Web.Security

Assembly:

System.Web.dll

Modifica la password per l'utente specificato.

public:
 override bool ChangePassword(System::String ^ username, System::String ^ oldPassword, System::String ^ newPassword);

public override bool ChangePassword (string username, string oldPassword, string newPassword);

override this.ChangePassword : string * string * string -> bool

Public Overrides Function ChangePassword (username As String, oldPassword As String, newPassword As String) As Boolean

Parametri

username

String

Nome dell'utente di cui aggiornare la password.

oldPassword

String

Password corrente dell'utente specificato.

newPassword

String

Nuova password per l'utente specificato.

Restituisce

Boolean

true se l'aggiornamento della password è riuscito. In caso contrario, false.

Eccezioni

ArgumentException

username è vuoto oppure supera la lunghezza massima per il nome utente (in genere 256 caratteri).

-oppure-

username contiene virgole.

-oppure-

Il nome utente è mappato sull'attributo userPrincipalName e il parametro username contiene barre rovesciate.

-oppure-

oldPassword oppure newPassword è una stringa di lunghezza zero.

-oppure-

oldPassword oppure newPassword supera la lunghezza massima della password (in genere 128 caratteri).

-oppure-

La lunghezza del parametro newPassword è inferiore alla lunghezza minima della password specificata nella proprietà MinRequiredPasswordLength.

-oppure-

Il numero di caratteri non alfabetici contenuti nel parametro newPassword è inferiore al valore specificato nella proprietà MinRequiredNonAlphanumericCharacters.

-oppure-

Il parametro newPassword non supera i criteri di convalida dell'espressione regolare definita nella proprietà PasswordStrengthRegularExpression.

ArgumentNullException

username è null.

-oppure-

oldPassword è null.

-oppure-

newPassword è null.

MembershipPasswordException

Il parametro newPassword non soddisfa i criteri di complessità definiti dal server Active Directory.

ProviderException

Non è stato possibile stabilire una connessione sicura con un server Active Directory Application Mode.

InvalidOperationException

Il metodo ChangePassword(String, String, String) viene chiamato prima che venga inizializzata l'istanza della classe ActiveDirectoryMembershipProvider.

Exception

Eccezione non gestita.

Commenti

Il ChangePassword metodo viene usato per aggiornare la password dell'utente nell'archivio dati di Active Directory. Indipendentemente dalle credenziali che l'istanza è configurata per l'uso ActiveDirectoryMembershipProvider , il provider si connette al server Active Directory usando i username parametri e oldPassword come credenziali di connessione.

Se la EnablePasswordReset proprietà è true, l'utente non può modificare la password se l'account è stato bloccato in precedenza perché l'utente ha effettuato troppi tentativi di rispondere alla domanda della password. L'utente dovrà attendere il numero di minuti specificato nella PasswordAnswerAttemptLockoutDuration proprietà prima di modificare la password.

Se la modifica della password ha esito positivo e la EnablePasswordReset proprietà è true, i contatori di rilevamento delle risposte alle password non valido dell'utente vengono reimpostati.

Il provider trova l'istanza utente da aggiornare eseguendo una ricerca sottoalbero per il nome utente a partire dal punto di ricerca specificato nella stringa di connessione. Per altre informazioni sulle stringhe di connessione, vedere l'argomento relativo alla ActiveDirectoryMembershipProvider classe.

Per modificare le password in un server Active Directory, l'attributo connectionProtection deve essere impostato su SignAndSeal.

Quando si usa un server ADAM, l'attributo connectionProtection può essere impostato su None, ma solo se si configura in modo esplicito il server ADAM per consentire la modifica della password su connessioni non protette.

Vedi anche

• Introduzione all'appartenenza a ASP.NET