MembershipUser Classe

Referência

Definição

Namespace:: System.Web.Security

Assembly:: System.Web.dll

Assembly:: System.Web.ApplicationServices.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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: System.Web.Security.ActiveDirectoryMembershipUser

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

Introdução à associação

Partilhar via