Поделиться через


MembershipUser Класс

Определение

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

public ref class MembershipUser
[System.Serializable]
public class MembershipUser
[<System.Serializable>]
type MembershipUser = class
Public Class MembershipUser
Наследование
MembershipUser
Производный
Атрибуты

Примеры

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

Важно!

В этом примере содержится текстовое поле, принимающее введенные пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах 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()

Отменяет заблокированное состояние пользователя, что позволяет проверить авторизованного пользователя.

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

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