ActiveDirectoryMembershipProvider.ChangePassword Metoda

Definice

Obor názvů:

System.Web.Security

Sestavení:

System.Web.dll

Změní heslo pro zadaného uživatele.

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

Parametry

username

String

Jméno uživatele, pro který se má heslo aktualizovat.

oldPassword

String

Aktuální heslo pro zadaného uživatele.

newPassword

String

Nové heslo pro zadaného uživatele.

Návraty

Boolean

truepokud se heslo úspěšně aktualizovalo; v opačném případě . false

Výjimky

ArgumentException

username je prázdné nebo překračuje maximální délku uživatelského jména (obvykle 256 znaků).

-nebo-

username obsahuje čárky.

-nebo-

Uživatelské jméno je namapováno na userPrincipalName atribut a username parametr obsahuje zpětná lomítka.

-nebo-

oldPassword nebo newPassword je řetězec nulové délky.

-nebo-

oldPassword nebo newPassword překračuje maximální délku hesla (obvykle 128 znaků).

-nebo-

newPassword je menší než minimální velikost hesla zadaná ve MinRequiredPasswordLength vlastnosti

-nebo-

newPassword obsahuje méně než počet neau abecedních znaků zadaných MinRequiredNonAlphanumericCharacters ve vlastnosti.

-nebo-

newPassword nezdaří ověření regulárním výrazem definovaným PasswordStrengthRegularExpression ve vlastnosti.

ArgumentNullException

username je null.

-nebo-

oldPassword je null.

-nebo-

newPassword je null.

MembershipPasswordException

newPassword nesplňuje požadavky na složitost definované serverem služby Active Directory.

ProviderException

K serveru aplikačního režimu služby Active Directory nebylo možné vytvořit zabezpečené připojení.

InvalidOperationException

Metoda ChangePassword(String, String, String) je volána před inicializována ActiveDirectoryMembershipProvider instance.

Exception

Došlo k neošetřené výjimce.

Poznámky

Metoda ChangePassword se používá k aktualizaci hesla uživatele v úložišti dat služby Active Directory. Bez ohledu na přihlašovací údaje, které ActiveDirectoryMembershipProvider je instance nakonfigurovaná pro použití, se zprostředkovatel připojí k serveru služby Active Directory pomocí username parametrů a oldPassword jako přihlašovacích údajů pro připojení.

EnablePasswordReset Pokud je truevlastnost , uživatel nemůže změnit heslo, pokud byl účet dříve uzamčen, protože uživatel provedl příliš mnoho pokusů odpovědět na otázku hesla. Uživatel bude muset před změnou hesla počkat na počet minut zadaných ve PasswordAnswerAttemptLockoutDuration vlastnosti.

Pokud je změna hesla úspěšná a EnablePasswordReset vlastnost je true, resetují se čítače pro sledování odpovědí na chybné heslo uživatele.

Zprostředkovatel najde instanci uživatele, která se má aktualizovat, vyhledáním uživatelského jména v podstromu počínaje vyhledávacím bodem zadaným v připojovacím řetězci. Další informace o připojovacích řetězcích najdete v ActiveDirectoryMembershipProvider tématu třídy.

Pokud chcete změnit hesla na serveru Služby Active Directory, connectionProtection musí být atribut nastavený na SignAndSealhodnotu .

Při použití serveru ADAM lze atribut nastavit na None, ale pouze v případě, že server ADAM explicitně nakonfigurujete tak, connectionProtection aby umožňoval změnu hesla přes nezabezpečená připojení.

Viz také

• Úvod do ASP.NET členství