ActiveDirectoryMembershipProvider.ChangePassword Метод

Определение

Пространство имен:

System.Web.Security

Сборка:

System.Web.dll

Изменяет пароль заданного пользователя.

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

Параметры

username

String

Имя пользователя, для которого нужно изменить пароль.

oldPassword

String

Текущий пароль заданного пользователя.

newPassword

String

Новый пароль заданного пользователя.

Возвращаемое значение

Boolean

Значение true, если пароль был успешно обновлен; в противном случае — значение false.

Исключения

ArgumentException

Параметр username пустой, или превышает максимальную длину имени пользователя (обычно 256 символов).

-или-

username содержит запятые.

-или-

Имя пользователя отображается на атрибут userPrincipalName и параметр username содержит обратные косые черты.

-или-

Параметр oldPassword или параметр newPassword является строкой нулевой длины.

-или-

Параметр oldPassword или newPassword превышает максимальную длину пароля (обычно 128 символов).

-или-

Длина параметра newPassword меньше минимальной длины пароля, указанной в свойстве MinRequiredPasswordLength.

-или-

Параметр newPassword содержит меньше нетекстовых символов, чем определено в свойстве MinRequiredNonAlphanumericCharacters.

-или-

Параметру newPassword не удается пройти проверку регулярным выражением, определенным в свойстве PasswordStrengthRegularExpression.

ArgumentNullException

username имеет значение null.

-или-

oldPassword имеет значение null.

-или-

newPassword имеет значение null.

MembershipPasswordException

Параметр newPassword не удовлетворяет требованиям сложности, определенным сервером Active Directory.

ProviderException

Нельзя создать безопасное подключение к серверу Active Directory Application Mode.

InvalidOperationException

Метод ChangePassword(String, String, String) вызывается до инициализации экземпляра ActiveDirectoryMembershipProvider.

Exception

Произошло необработанное исключение.

Комментарии

Метод ChangePassword используется для обновления пароля пользователя в хранилище данных Active Directory. Независимо от учетных данных, для ActiveDirectoryMembershipProvider использования которыми настроен экземпляр, поставщик подключается к серверу Active Directory, используя username параметры и oldPassword в качестве учетных данных подключения.

EnablePasswordReset Если свойство имеет значение true, пользователь не может изменить свой пароль, если учетная запись была заблокирована ранее из-за слишком большого количества попыток ответить на вопрос о пароле. Пользователю потребуется подождать количество минут, указанное в свойстве PasswordAnswerAttemptLockoutDuration , перед изменением пароля.

Если изменение пароля выполнено успешно и EnablePasswordReset свойство имеет значение true, счетчики отслеживания неправильных ответов паролей пользователя сбрасываются.

Поставщик находит экземпляр пользователя для обновления путем выполнения поддеревого поиска имени пользователя, начиная с точки поиска, указанной в строке подключения. ActiveDirectoryMembershipProvider Дополнительные сведения о строках подключения см. в разделе о классах.

Чтобы изменить пароли на сервере Active Directory, connectionProtection атрибуту необходимо задать значение SignAndSeal.

При использовании сервера ADAM атрибуту можно присвоить значение None, но только в том случае, connectionProtection если вы явно настроили сервер ADAM, чтобы разрешить изменение пароля через незащищенные подключения.

См. также раздел

• Общие сведения о членстве ASP.NET