This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

SqlMembershipProvider.ChangePassword أسلوب

Visual Studio 2010

Modifies a مستخدم's كلمة المرور.

مساحة الاسم:  System.Web.Security
التجميع:  System.Web (في System.Web.dll)

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

المعلمات

username
النوع: System.String
The مستخدم إلى تحديث the كلمة المرور for.
oldPassword
النوع: System.String
The الحالي كلمة المرور for the specified مستخدم.
newPassword
النوع: System.String
The كلمة المرور الجديدة for the specified مستخدم.

القيمة المُرجعة

النوع: System.Boolean
true if the كلمة المرور was محدث successfully. false if the supplied كلمة المرور القديمة هو غير صالح, the مستخدم هو مؤمّن خارج, أو the مستخدم غير موجود في the قاعدة بيانات.

استثناء:شرط
System.ArgumentException

username هو an فارغ سلسلة (""), يحتوي على a فاصلة, أو هو longer than 256 حرف/ حروف.

-أو-

oldPassword هو an فارغ سلسلة أو longer than 128 حرف/ حروف.

-أو-

newPassword هو an فارغ سلسلة أو longer than 128 حرف/ حروف.

-أو-

The encoded الإصدار of newPassword هو أكبر من 128 حرف/ حروف.

-أو-

تم إلغاء إجراء تغيير-كلمة المرور بواسطة مشترك إلى ValidatingPasswordحدث، و FailureInformationتم خاصية null.

-أو-

الطول newPasswordهو أصغر من من الحد الأدنى للطول المحدد في MinRequiredPasswordLengthخاصية.

-أو-

عدد حرف/ حروف غير الهجائية في newPasswordهو أصغر من من العدد المطلوب من حرف/ حروف غير الهجائية المعين في MinRequiredNonAlphanumericCharactersخاصية.

-أو-

newPasswordلا يمر تعبير عادي المعرفة فيPasswordStrengthRegularExpressionخاصية.

System.ArgumentNullException

username هو null.

-أو-

oldPassword هو null.

-أو-

newPassword هو null.

MembershipPasswordException

usernameغير موجود في قاعدة بيانات.

System.Configuration.Provider.ProviderException

حدث خطأ أثناء إعداد جديد القيمة كلمة المرور في قاعدة بيانات.

Exception

حدث استثناء غير معالج.

Th هو أسلوب هو استدعاؤها بواسطة Membershipفئة بتحديث كلمة المرور الخاصة بمستخدم في خادم قاعدة بيانات SQL المحدد في ملف تكوين للتطبيق ASP.NET (ويب.config).

يكون الطول كلمة المرور الحد الأقصى هو 128 حرف/ حروف.

إذا كانت كلمة مرور غير صحيحة هو تزويدك ChangePasswordالأسلوب، العداد الداخلية التي تتعقب محاولات كلمة المرور غير صالحة هو يتزايد بمقدار. يمكن أن يؤدي هذا مستخدم يتم قفله وقادر تشغيل يسجل تشغيل حتى يتم إلغاء تحديد حالة القفل بمكالمة إلى UnlockUserالأسلوب. إذا كانت كلمة المرور الصحيحة هو المتوفرة ومستخدم هو لا حاليا مؤمّن، ثم يتم يعيد تعيين المعاملة عدادات الداخلية التي تمقطع صوتي محاولات كلمة المرور والإجابة بكلمة مرور غير صحيحة إلى الصفر. لمزيد من المعلومات، راجع MaxInvalidPasswordAttemptsو PasswordAttemptWindowالخصائص.

يمكنك استدعاء ChangePasswordأسلوب مباشرة بواسطة أولاً الحصول على مرجع إلى SqlMembershipProviderمثيل من خلال Providerخاصية Membershipفئة. Provider يعرض الخصائص defaultProviderالمحدد في ملف ويب.config للتطبيق. تكوين موفري غير الموفر الافتراضي للرجوع إليها باستخدام Providersخاصية.

يمكنك أيضا تغيير كلمات مرور مستخدم باستخدام ChangePasswordأسلوب.

بادئة و يتم قطع مسافات زائدة من الجميع قيم المعلمات.

يلي تعليمات برمجية مثال تعديل كلمة المرور لمستخدم معين.

ملاحظةملاحظة

يستخدم هذا المثال Providerخاصية Membershipفئة إلى استدعاء SqlMembershipProviderالمحدد defaultProviderفي ملف ويب.config. إذا كنت تحتاج إلى الوصول إلى موفر الافتراضي ك نوع SqlMembershipProvider، يمكن تحويل Providerخاصية Membershipفئة. تكوين موفري كنوع موفر محدد الوصول إلى الآخر، يمكن الوصول إليها مع الاسم المكون مع Providersخاصية Membershipالفئة و تحويل عليها كنوع الموفر المحدد.


<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

public void ChangePassword_OnClick(object sender, EventArgs args)
{
  try
  {
    // Update the password.

    if (Membership.Provider.ChangePassword(User.Identity.Name, OldPasswordTextbox.Text, PasswordTextbox.Text))
    {
      Msg.Text = "Password changed.";
      return;
    }
  }
  catch
  {
  }

  Msg.Text = "Password change failed. Please re-enter your values and try again.";
}


</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Change Password</title>
</head>
<body>

<form id="form1" runat="server">
  <h3>Change Password for <%=User.Identity.Name%></h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server" />

  <table cellpadding="3" border="0">
    <tr>
      <td>Old Password:</td>
      <td><asp:Textbox id="OldPasswordTextbox" runat="server" TextMode="Password" /></td>
      <td><asp:RequiredFieldValidator id="OldPasswordRequiredValidator" runat="server"
                                      ControlToValidate="OldPasswordTextbox" ForeColor="red"
                                      Display="Static" ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td>Password:</td>
      <td><asp:Textbox id="PasswordTextbox" runat="server" TextMode="Password" /></td>
      <td><asp:RequiredFieldValidator id="PasswordRequiredValidator" runat="server"
                                      ControlToValidate="PasswordTextbox" ForeColor="red"
                                      Display="Static" ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td>Confirm Password:</td>
      <td><asp:Textbox id="PasswordConfirmTextbox" runat="server" TextMode="Password" /></td>
      <td><asp:RequiredFieldValidator id="PasswordConfirmRequiredValidator" runat="server"
                                      ControlToValidate="PasswordConfirmTextbox" ForeColor="red"
                                      Display="Static" 
                                      ErrorMessage="Required" />
          <asp:CompareValidator id="PasswordConfirmCompareValidator" runat="server"
                                      ControlToValidate="PasswordConfirmTextbox" ForeColor="red"
                                      Display="Static" ControlToCompare="PasswordTextBox"
                                      ErrorMessage="Confirm password must match password." />
      </td>
    </tr>
    <tr>
      <td></td>
      <td><asp:Button id="ChangePasswordButton" Text="Change Password" 
                      OnClick="ChangePassword_OnClick" runat="server" /></td>
    </tr>
  </table>
</form>

</body>
</html>


نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: