MembershipUser Classe

  • Referência

Definição

Namespace:
System.Web.Security
Assembly:
System.Web.dll
Assembly:
System.Web.ApplicationServices.dll

Expõe e atualiza as informações de usuário associado no armazenamento de dados de associação.

public ref class MembershipUser
[System.Serializable]
public class MembershipUser
[<System.Serializable>]
type MembershipUser = class
Public Class MembershipUser
Herança
Object
MembershipUser
Derivado
Atributos
SerializableAttribute

Exemplos

O exemplo de código a seguir atualiza o endereço de email de um usuário.

Importante

Este exemplo contém uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.

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

Comentários

O MembershipUser objeto é usado para representar um único usuário de associação no armazenamento de dados de associação. Ele expõe informações sobre o usuário associado, como o endereço de email, e fornece funcionalidade para o usuário associado, como a capacidade de alterar ou redefinir sua senha.

Observação

Se você não estiver familiarizado com os recursos de associação do ASP.NET, consulte Introdução à associação antes de continuar. Para obter uma lista de outros tópicos relacionados à associação, consulte Gerenciando usuários usando associação.

Um MembershipUser objeto é retornado pelos GetUser métodos e CreateUser ou como parte de um MembershipUserCollection retornado pelos GetAllUsersmétodos , FindUsersByNamee FindUsersByEmail .

Um MembershipUser objeto é exigido pelo UpdateUser método quando você deseja atualizar as informações de um usuário de associação existente.

Construtores

MembershipUser()

Cria uma nova instância de um objeto MembershipUser para uma classe que herda a classe MembershipUser.
MembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)

Cria um novo objeto de usuário associado com os valores da propriedade especificados.

Propriedades

Comment

Obtém ou define informações específicas do aplicativo para o usuário associado.
CreationDate

Obtém a data e hora quando o usuário foi adicionado ao armazenamento de dados de associação.
Email

Obtém ou define o endereço de email do usuário associado.
IsApproved

Obtém ou define se o usuário associado pode ser autenticado.
IsLockedOut

Obtém um valor que indica se o usuário associado está bloqueado e não pode ser validado.
IsOnline

Especifica se o usuário está online no momento.
LastActivityDate

Obtém ou define a última data e a hora em que o usuário associado foi autenticado ou acessou o aplicativo.
LastLockoutDate

Obtém a data e a hora mais recentes em que o usuário associado foi bloqueado.
LastLoginDate

Obtém ou define a data e hora em que o usuário foi autenticado pela última vez.
LastPasswordChangedDate

Obtém a data e a hora da atualização mais recente da senha do usuário associado.
PasswordQuestion

Obtém a pergunta da senha do usuário associado.
ProviderName

Obtém o nome do provedor de associação que armazena e recupera informações de usuário para o usuário associado.
ProviderUserKey

Obtém o identificador de usuário da fonte de dados de associação para o usuário.
UserName

Obtém o nome de logon do usuário associado.

Métodos

ChangePassword(String, String)

Atualiza a senha do usuário associado no armazenamento de dados de associação.
ChangePasswordQuestionAndAnswer(String, String, String)

Atualiza a pergunta e resposta de senha do usuário associado no armazenamento de dados de associação.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetPassword()

Obtém a senha do usuário associado do armazenamento de dados de associação.
GetPassword(String)

Obtém a senha do usuário associado do armazenamento de dados de associação.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ResetPassword()

Redefine a senha de um usuário com uma nova senha gerada automaticamente.
ResetPassword(String)

Redefine a senha de um usuário com uma nova senha gerada automaticamente.
ToString()

Retorna o nome de usuário para o usuário associado.
UnlockUser()

Limpa o estado bloqueado do usuário para que o usuário associado possa ser validado.

Aplica-se a

Confira também