ActiveDirectoryMembershipProvider.ChangePassword Yöntem

Başvuru

Tanım

Ad Alanı:: System.Web.Security

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belirtilen kullanıcının parolasını değiştirir.

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

Parametreler

username: String

Parolasının güncelleştirilecek kullanıcı adı.

oldPassword: String

Belirtilen kullanıcının geçerli parolası.

newPassword: String

Belirtilen kullanıcının yeni parolası.

Döndürülenler

Boolean

true parola başarıyla güncelleştirildiyse; aksi takdirde , false.

Özel durumlar

ArgumentException

username boş veya kullanıcı adı için uzunluk üst sınırını (genellikle 256 karakter) aşıyor.

-veya- username virgül içerir.

-veya- Kullanıcı adı özniteliğine userPrincipalName eşlenir ve username parametresi ters eğik çizgi içerir.

-veya- oldPassword veya newPassword sıfır uzunluklu bir dizedir.

-veya- oldPassword veya newPassword en fazla parola uzunluğunu (genellikle 128 karakter) aşıyor.

-veya- newPassword özelliğinde belirtilen en düşük parola boyutundan MinRequiredPasswordLength küçük -veya- newPassword özelliğinde belirtilen alfabetik olmayan karakter sayısından MinRequiredNonAlphanumericCharacters daha azını içerir.

-veya- newPassword özelliğinde PasswordStrengthRegularExpression tanımlanan normal ifade tarafından doğrulanamadı.

ArgumentNullException

username, null değeridir.

-veya- oldPassword, null değeridir.

-veya- newPassword, null değeridir.

MembershipPasswordException

newPassword Active Directory sunucusu tarafından tanımlanan karmaşıklık gereksinimlerini karşılamaz.

ProviderException

Active Directory Uygulama Modu sunucusuna güvenli bir bağlantı oluşturulamadı.

InvalidOperationException

ChangePassword(String, String, String) Yöntem, örnek başlatılmadan önce ActiveDirectoryMembershipProvider çağrılır.

Exception

İşlenmeyen bir özel durum oluştu.

Açıklamalar

ChangePassword yöntemi, Active Directory veri deposunda kullanıcının parolasını güncelleştirmek için kullanılır. Örneğin kullanmak üzere yapılandırıldığı kimlik bilgileri ActiveDirectoryMembershipProvider ne olursa olsun, sağlayıcı bağlantı kimlik bilgileri olarak ve oldPassword parametrelerini kullanarak username Active Directory sunucusuna bağlanır.

EnablePasswordReset özelliği isetrue, kullanıcı parola sorusunu yanıtlamak için çok fazla deneme yaptığından hesap daha önce kilitlenmişse kullanıcı parolasını değiştiremez. Kullanıcının parolayı değiştirmeden önce özelliğinde PasswordAnswerAttemptLockoutDuration belirtilen dakika sayısını beklemesi gerekir.

Parola değişikliği başarılı olursa ve EnablePasswordReset özelliği ise truekullanıcının hatalı parola yanıt izleme sayaçları sıfırlanır.

Sağlayıcı, bağlantı dizesinde belirtilen arama noktasından başlayarak kullanıcı adı için bir alt ağaç araması gerçekleştirerek güncelleştirilecek kullanıcı örneğini bulur. ActiveDirectoryMembershipProvider Bağlantı dizeleri hakkında daha fazla bilgi için sınıf konusuna bakın.

Bir Active Directory sunucusundaki parolaları değiştirmek için özniteliği olarak connectionProtection ayarlanmalıdır SignAndSeal.

ADAM sunucusu kullanılırken, connectionProtection özniteliği olarak ayarlanabilir None, ancak yalnızca ADAM sunucusunu güvenli olmayan bağlantılar üzerinden parola değişikliğine izin verecek şekilde açıkça yapılandırıyorsanız.

Şunlara uygulanır

Ayrıca bkz.

ASP.NET Üyeliğine Giriş