ActiveDirectoryMembershipProvider.ChangePassword Metoda

Definicja

Przestrzeń nazw:

System.Web.Security

Zestaw:

System.Web.dll

Zmienia hasło określonego użytkownika.

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

Nazwa użytkownika do zaktualizowania hasła.

oldPassword

String

Bieżące hasło dla określonego użytkownika.

newPassword

String

Nowe hasło dla określonego użytkownika.

Zwraca

Boolean

true jeśli hasło zostało pomyślnie zaktualizowane; w przeciwnym razie , false.

Wyjątki

ArgumentException

username jest pusta lub przekracza maksymalną długość nazwy użytkownika (zwykle 256 znaków).

-lub-

username zawiera przecinki.

-lub-

Nazwa użytkownika jest mapowana na userPrincipalName atrybut, a username parametr zawiera ukośniki odwrotne.

-lub-

oldPassword lub newPassword jest ciągiem o zerowej długości.

-lub-

oldPassword lub newPassword przekracza maksymalną długość hasła (zwykle 128 znaków).

-lub-

newPassword jest mniejsza niż minimalny rozmiar hasła określony we MinRequiredPasswordLength właściwości

-lub-

newPassword zawiera mniej niż liczba znaków innych niż alfabetyczne określone we MinRequiredNonAlphanumericCharacters właściwości.

-lub-

newPassword weryfikacja kończy się niepowodzeniem przez wyrażenie regularne zdefiniowane we PasswordStrengthRegularExpression właściwości .

ArgumentNullException

username to null.

-lub-

oldPassword to null.

-lub-

newPassword to null.

MembershipPasswordException

newPassword nie spełnia wymagań dotyczących złożoności zdefiniowanych przez serwer usługi Active Directory.

ProviderException

Nie można nawiązać bezpiecznego połączenia z serwerem trybu aplikacji usługi Active Directory.

InvalidOperationException

Metoda jest wywoływana ChangePassword(String, String, String) przed zainicjowanym wystąpieniem ActiveDirectoryMembershipProvider .

Exception

Wystąpił nieobsługiwany wyjątek.

Uwagi

Metoda ChangePassword służy do aktualizowania hasła użytkownika w magazynie danych usługi Active Directory. Niezależnie od poświadczeń skonfigurowanych ActiveDirectoryMembershipProvider do użycia przez wystąpienie dostawca łączy się z serwerem usługi Active Directory przy użyciu username parametrów i oldPassword jako poświadczeń połączenia.

EnablePasswordReset Jeśli właściwość to true, użytkownik nie może zmienić hasła, jeśli konto zostało wcześniej zablokowane, ponieważ użytkownik podjął zbyt wiele prób udzielenia odpowiedzi na pytanie o hasło. Użytkownik będzie musiał poczekać liczbę minut określonych we PasswordAnswerAttemptLockoutDuration właściwości przed zmianą hasła.

Jeśli zmiana hasła powiedzie się, a EnablePasswordReset właściwość to true, liczniki śledzenia odpowiedzi na hasło użytkownika zostaną zresetowane.

Dostawca znajduje wystąpienie użytkownika do aktualizacji, wykonując wyszukiwanie poddrzewa nazwy użytkownika, zaczynając od punktu wyszukiwania określonego w parametrach połączenia. Zobacz temat klasy, ActiveDirectoryMembershipProvider aby uzyskać więcej informacji na temat parametrów połączenia.

Aby zmienić hasła na serwerze usługi Active Directory, connectionProtection należy ustawić atrybut na SignAndSeal.

W przypadku korzystania z serwera ADAM atrybut można ustawić na None, ale tylko wtedy, connectionProtection gdy jawnie skonfigurujesz serwer ADAM, aby zezwolić na zmianę hasła przez niezabezpieczone połączenia.

Zobacz też

• Wprowadzenie do członkostwa w ASP.NET