MembershipUser Clase

Definición

Espacio de nombres:: System.Web.Security

Ensamblado:: System.Web.dll

Ensamblado:: System.Web.ApplicationServices.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Expone y actualiza la información del usuario de pertenencia en el almacén de datos de pertenencia.

public ref class MembershipUser

[System.Serializable]
public class MembershipUser

[<System.Serializable>]
type MembershipUser = class

Public Class MembershipUser

Herencia: Object
MembershipUser

Derivado: System.Web.Security.ActiveDirectoryMembershipUser

Atributos: SerializableAttribute

Ejemplos

En el ejemplo de código siguiente se actualiza la dirección de correo electrónico de un usuario.

Importante

Este ejemplo contiene un cuadro de texto que acepta la entrada del usuario, que es una amenaza de seguridad potencial. De forma predeterminada, ASP.NET páginas web validan que la entrada del usuario no incluye elementos HTML ni de script. Para obtener más información, consulte Información general sobre vulnerabilidades de seguridad 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>

Comentarios

El MembershipUser objeto se usa para representar un único usuario de pertenencia en el almacén de datos de pertenencia. Expone información sobre el usuario de pertenencia, como la dirección de correo electrónico, y proporciona funcionalidad para el usuario de pertenencia, como la capacidad de cambiar o restablecer su contraseña.

Note

Si no está familiarizado con las características de pertenencia de ASP.NET, consulte Introducción a la pertenencia antes de continuar. Para obtener una lista de otros temas relacionados con la pertenencia, consulte Administración de usuarios mediante pertenencia.

Los métodos y devuelven un MembershipUser objeto GetUser o como parte de un CreateUser devuelto por los MembershipUserCollectionmétodos , GetAllUsersy FindUsersByName .FindUsersByEmail

El método requiere UpdateUser un MembershipUser objeto cuando desea actualizar la información de un usuario de pertenencia existente.

Constructores

Nombre	Description
MembershipUser()	Crea una nueva instancia de un MembershipUser objeto para una clase que hereda la MembershipUser clase .
MembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)	Crea un nuevo objeto de usuario de pertenencia con los valores de propiedad especificados.

Propiedades

Nombre	Description
Comment	Obtiene o establece información específica de la aplicación para el usuario de pertenencia.
CreationDate	Obtiene la fecha y hora en que el usuario se agregó al almacén de datos de pertenencia.
Email	Obtiene o establece la dirección de correo electrónico del usuario de pertenencia.
IsApproved	Obtiene o establece si el usuario de pertenencia se puede autenticar.
IsLockedOut	Obtiene un valor que indica si el usuario de pertenencia está bloqueado y no se puede validar.
IsOnline	Obtiene si el usuario está actualmente en línea.
LastActivityDate	Obtiene o establece la fecha y hora en que el usuario de pertenencia se autentique por última vez o tenga acceso a la aplicación.
LastLockoutDate	Obtiene la fecha y hora más recientes en que se bloqueó el usuario de pertenencia.
LastLoginDate	Obtiene o establece la fecha y hora en que el usuario se autenticó por última vez.
LastPasswordChangedDate	Obtiene la fecha y hora en que se actualizó por última vez la contraseña del usuario de pertenencia.
PasswordQuestion	Obtiene la pregunta de contraseña del usuario de pertenencia.
ProviderName	Obtiene el nombre del proveedor de pertenencia que almacena y recupera información de usuario para el usuario de pertenencia.
ProviderUserKey	Obtiene el identificador de usuario del origen de datos de pertenencia para el usuario.
UserName	Obtiene el nombre de inicio de sesión del usuario de pertenencia.

Métodos

Nombre	Description
ChangePassword(String, String)	Actualiza la contraseña del usuario de pertenencia en el almacén de datos de pertenencia.
ChangePasswordQuestionAndAnswer(String, String, String)	Actualiza la pregunta y respuesta de contraseña para el usuario de pertenencia en el almacén de datos de pertenencia.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetPassword()	Obtiene la contraseña del usuario de pertenencia del almacén de datos de pertenencia.
GetPassword(String)	Obtiene la contraseña del usuario de pertenencia del almacén de datos de pertenencia.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ResetPassword()	Restablece la contraseña de un usuario a una nueva contraseña generada automáticamente.
ResetPassword(String)	Restablece la contraseña de un usuario a una nueva contraseña generada automáticamente.
ToString()	Devuelve el nombre de usuario del usuario de pertenencia.
UnlockUser()	Borra el estado bloqueado del usuario para que se pueda validar el usuario de pertenencia.

Se aplica a

Consulte también

Introducción a la pertenencia

Comentarios

¿Le ha resultado útil esta página?