MembershipUser Класс

Ссылка

Определение

Пространство имен:: System.Web.Security

Сборка:: System.Web.dll

Сборка:: System.Web.ApplicationServices.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет и обновляет сведения об авторизованном пользователе в хранилище данных членства.

public ref class MembershipUser

[System.Serializable]
public class MembershipUser

[<System.Serializable>]
type MembershipUser = class

Public Class MembershipUser

Наследование: Object
MembershipUser

Производный: System.Web.Security.ActiveDirectoryMembershipUser

Атрибуты: SerializableAttribute

Примеры

В следующем примере кода обновляется адрес электронной почты пользователя.

Важно!

В этом примере содержится текстовое поле, которое принимает введенные пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.

<%@ 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">

MembershipUser u;

public void Page_Load(object sender, EventArgs args)
{
  u = Membership.GetUser(User.Identity.Name);

  if (!IsPostBack)
  {
    EmailTextBox.Text = u.Email; 
  }
}

public void UpdateEmailButton_OnClick(object sender, EventArgs args)
{
  try
  {
    u.Email = EmailTextBox.Text;

    Membership.UpdateUser(u);
  
    Msg.Text = "User email updated.";
  }
  catch (System.Configuration.Provider.ProviderException e)
  {
    Msg.Text = e.Message;
  }
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Update User E-Mail</title>
</head>
<body>

<form id="form1" runat="server">
  <h3>Update E-Mail Address for <%=User.Identity.Name%></h3>

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

  <table cellpadding="3" border="0">
    <tr>
      <td>Email Address:</td>
      <td><asp:TextBox id="EmailTextBox" MaxLength="128" Columns="30" runat="server" /></td>
      <td><asp:RequiredFieldValidator id="EmailRequiredValidator" runat="server"
                                    ControlToValidate="EmailTextBox" ForeColor="red"
                                    Display="Static" ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td></td>
      <td><asp:Button id="UpdateEmailButton" 
                      Text="Update Email" 
                      OnClick="UpdateEmailButton_OnClick" 
                      runat="server" /></td>
    </tr>
  </table>
</form>

</body>
</html>

<%@ Page Language="vb" %>
<%@ 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">

Dim u As MembershipUser

Public Sub Page_Load(sender As Object, args As EventArgs)

  u = Membership.GetUser(User.Identity.Name)

  If Not IsPostBack Then EmailTextBox.Text = u.Email

End Sub

Public Sub UpdateEmailButton_OnClick(sender As Object, args As EventArgs)

  Try
    u.Email = EmailTextBox.Text

    Membership.UpdateUser(u)
  
    Msg.Text = "User email updated."
  Catch e As System.Configuration.Provider.ProviderException
    Msg.Text = e.Message
  End Try

End Sub

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Update User E-Mail</title>
</head>
<body>

<form id="form1" runat="server">
  <h3>Update E-Mail Address for <%=User.Identity.Name%></h3>

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

  <table cellpadding="3" border="0">
    <tr>
      <td>Email Address:</td>
      <td><asp:TextBox id="EmailTextBox" MaxLength="128" Columns="30" runat="server" /></td>
      <td><asp:RequiredFieldValidator id="EmailRequiredValidator" runat="server"
                                    ControlToValidate="EmailTextBox" ForeColor="red"
                                    Display="Static" ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td></td>
      <td><asp:Button id="UpdateEmailButton" 
                      Text="Update Email" 
                      OnClick="UpdateEmailButton_OnClick" 
                      runat="server" /></td>
    </tr>
  </table>
</form>

</body>
</html>

Объект MembershipUser используется для представления одного пользователя членства в хранилище данных членства. Он предоставляет сведения о пользователе членства, например адресе электронной почты, и предоставляет функциональные возможности для пользователя членства, например возможность изменить или сбросить пароль.

Примечание

Если вы не знакомы с функциями членства ASP.NET, ознакомьтесь с общими сведениями о членстве, прежде чем продолжить. Список других разделов, связанных с членством, см. в разделе "Управление пользователями с помощью членства".

MembershipUser Объект возвращается методами GetUser и CreateUser методами или в составе возвращаемого MembershipUserCollection GetAllUsers FindUsersByNameими объекта и FindUsersByEmail методов.

MembershipUser Объект требуется методомUpdateUser, если требуется обновить сведения для существующего пользователя членства.

Конструкторы

MembershipUser()	Создает экземпляр объекта MembershipUser для класса, который наследуется от класса MembershipUser.
MembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)	Создает новый пользовательский объект членства с указанными значениями свойств.

Свойства

Comment	Возвращает или задает связанные с приложением сведения для авторизованного пользователя.
CreationDate	Возвращает дату и время добавления пользователя в хранилище данных членства.
Email	Получает или задает адрес электронной почты для пользователя членства.
IsApproved	Получает или задает значение, указывающее, может ли авторизованный пользователь проходить проверку подлинности.
IsLockedOut	Возвращает значение, указывающее, заблокирован ли авторизованный пользователь, что делает его проверку невозможной.
IsOnline	Получает значение, указывающее, находится ли пользователь в сети в настоящее время.
LastActivityDate	Получает или задает дату и время, когда авторизованный пользователь последний раз проходил проверку подлинности или получал доступ к приложению.
LastLockoutDate	Получает последние дату и время блокировки пользователя членства.
LastLoginDate	Получает или задает дату и время, когда пользователь последний раз проходил проверку подлинности.
LastPasswordChangedDate	Получает дату и время последнего обновления пароля авторизованного пользователя.
PasswordQuestion	Возвращает проверочный вопрос для авторизованного пользователя.
ProviderName	Получает имя поставщика членства, который сохраняет и извлекает пользовательскую информацию для авторизованного пользователя.
ProviderUserKey	Получает идентификатор пользователя из источника данных членства для пользователя.
UserName	Получает имя входа авторизованного пользователя.

Методы

ChangePassword(String, String)	Обновляет пароль авторизованного пользователя в хранилище данных членства.
ChangePasswordQuestionAndAnswer(String, String, String)	Обновляет вопрос для проверки пароля авторизованного пользователя и ответ на него в хранилище данных членства.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetPassword()	Возвращает пароль для авторизованного пользователя из хранилища данных членства.
GetPassword(String)	Возвращает пароль для авторизованного пользователя из хранилища данных членства.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ResetPassword()	Сбрасывает пароль пользователя и устанавливает новый, автоматически сгенерированный пароль.
ResetPassword(String)	Сбрасывает пароль пользователя и устанавливает новый, автоматически сгенерированный пароль.
ToString()	Возвращает имя пользователя для авторизованного пользователя.
UnlockUser()	Отменяет заблокированное состояние пользователя, что позволяет проверить авторизованного пользователя.

Применяется к

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

Общие сведения о членстве