MembershipUser MembershipUser MembershipUser MembershipUser Class

Definición

Expone y actualiza información del usuario de pertenencia en el almacén de datos de la pertenencia.Exposes and updates membership user information in the membership data store.

public ref class MembershipUser
[System.Serializable]
public class MembershipUser
type MembershipUser = class
Public Class MembershipUser
Herencia
MembershipUserMembershipUserMembershipUserMembershipUser
Derivado
Atributos

Ejemplos

En el ejemplo de código siguiente se actualiza la dirección de correo electrónico para un usuario.The following code example updates the email address for a user.

Importante

En este ejemplo contiene un cuadro de texto que acepta datos proporcionados por el usuario, que puede suponer una amenaza de seguridad.This example contains a text box that accepts user input, which is a potential security threat. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para más información, consulte Información general sobre los ataques mediante scripts.For more information, see Script Exploits Overview.

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

La MembershipUser objeto se usa para representar un usuario de pertenencia único en el almacén de datos de pertenencia.The MembershipUser object is used to represent a single membership user in the membership data store. Expone información sobre el usuario de pertenencia, como la dirección de correo electrónico y proporciona la funcionalidad para el usuario de pertenencia, como la capacidad de cambiar o restablecer su contraseña.It exposes information about the membership user such as the email address, and provides functionality for the membership user such as the ability to change or reset his or her password.

Nota

Si no está familiarizado con las características de pertenencia de ASP.NET, consulte Introducción a la suscripción antes de continuar.If you are not familiar with the membership features of ASP.NET, see Introduction to Membership before continuing. Para obtener una lista de otros temas relacionados con la pertenencia, vea administrar usuarios mediante pertenencia.For a list of other topics related to membership, see Managing Users by Using Membership.

Un MembershipUser objeto devuelto por la GetUser y CreateUser métodos o como parte de un MembershipUserCollection devuelto por la GetAllUsers, FindUsersByName, y FindUsersByEmail métodos.A MembershipUser object is returned by the GetUser and CreateUser methods or as part of a MembershipUserCollection returned by the GetAllUsers, FindUsersByName, and FindUsersByEmail methods.

Un MembershipUser objeto requiere el UpdateUser método cuando desee actualizar la información de un usuario de pertenencia existente.A MembershipUser object is required by the UpdateUser method when you want to update the information for an existing membership user.

Constructores

MembershipUser() MembershipUser() MembershipUser() MembershipUser()

Crea una nueva instancia de un objeto MembershipUser para una clase que hereda la clase MembershipUser.Creates a new instance of a MembershipUser object for a class that inherits the MembershipUser class.

MembershipUser(String, String, DateTime, DateTime, DateTime, Object, String, String, String, Boolean, Boolean, DateTime, DateTime) MembershipUser(String, String, DateTime, DateTime, DateTime, Object, String, String, String, Boolean, Boolean, DateTime, DateTime) MembershipUser(String, String, DateTime, DateTime, DateTime, Object, String, String, String, Boolean, Boolean, DateTime, DateTime) MembershipUser(String, String, DateTime, DateTime, DateTime, Object, String, String, String, Boolean, Boolean, DateTime, DateTime)

Crea un nuevo objeto de usuario de pertenencia con los valores de propiedades especificados.Creates a new membership user object with the specified property values.

Propiedades

Comment Comment Comment Comment

Obtiene o establece la información específica de la aplicación para el usuario de pertenencia.Gets or sets application-specific information for the membership user.

CreationDate CreationDate CreationDate CreationDate

Obtiene la fecha y la hora en que se agregó el usuario al almacén de datos de la suscripción.Gets the date and time when the user was added to the membership data store.

Email Email Email Email

Obtiene o establece la dirección de correo electrónico del usuario de pertenencia.Gets or sets the email address for the membership user.

IsApproved IsApproved IsApproved IsApproved

Obtiene o establece si se puede autenticar el usuario de pertenencia.Gets or sets whether the membership user can be authenticated.

IsLockedOut IsLockedOut IsLockedOut IsLockedOut

Obtiene un valor que indica si se bloquea el usuario de pertenencia y no se puede validar.Gets a value indicating whether the membership user is locked out and unable to be validated.

IsOnline IsOnline IsOnline IsOnline

Obtiene si el usuario está actualmente en línea.Gets whether the user is currently online.

LastActivityDate LastActivityDate LastActivityDate LastActivityDate

Obtiene o establece la fecha y hora en la que el usuario de pertenencia fue autenticado por última vez o tuvo acceso a la aplicación.Gets or sets the date and time when the membership user was last authenticated or accessed the application.

LastLockoutDate LastLockoutDate LastLockoutDate LastLockoutDate

Obtiene la más fecha y hora más reciente en la que se bloqueó al usuario de pertenenciaGets the most recent date and time that the membership user was locked out.

LastLoginDate LastLoginDate LastLoginDate LastLoginDate

Obtiene o establece la fecha y hora en la que el usuario fue autenticado por última vez.Gets or sets the date and time when the user was last authenticated.

LastPasswordChangedDate LastPasswordChangedDate LastPasswordChangedDate LastPasswordChangedDate

Obtiene la fecha y hora en la que la contraseña del usuario de pertenencia fue actualizada por última vez.Gets the date and time when the membership user's password was last updated.

PasswordQuestion PasswordQuestion PasswordQuestion PasswordQuestion

Obtiene la pregunta de la contraseña para el usuario de pertenencia.Gets the password question for the membership user.

ProviderName ProviderName ProviderName ProviderName

Obtiene el nombre del proveedor de pertenencia que almacena y recupera información de usuario correspondiente al usuario de pertenencia.Gets the name of the membership provider that stores and retrieves user information for the membership user.

ProviderUserKey ProviderUserKey ProviderUserKey ProviderUserKey

Obtiene el identificador de usuario correspondiente al usuario desde el origen de datos de la pertenencia.Gets the user identifier from the membership data source for the user.

UserName UserName UserName UserName

Obtiene el nombre de inicio de sesión del usuario de pertenencia.Gets the logon name of the membership user.

Métodos

ChangePassword(String, String) ChangePassword(String, String) ChangePassword(String, String) ChangePassword(String, String)

Actualiza la contraseña del usuario de pertenencia en el almacén de datos de pertenencia.Updates the password for the membership user in the membership data store.

ChangePasswordQuestionAndAnswer(String, String, String) ChangePasswordQuestionAndAnswer(String, String, String) ChangePasswordQuestionAndAnswer(String, String, String) ChangePasswordQuestionAndAnswer(String, String, String)

Actualiza la pregunta y la respuesta de la contraseña para el usuario de pertenencia en el almacén de datos de pertenencia.Updates the password question and answer for the membership user in the membership data store.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetPassword() GetPassword() GetPassword() GetPassword()

Obtiene la contraseña del almacén de datos de pertenencia para el usuario de pertenencia.Gets the password for the membership user from the membership data store.

GetPassword(String) GetPassword(String) GetPassword(String) GetPassword(String)

Obtiene la contraseña del almacén de datos de pertenencia para el usuario de pertenencia.Gets the password for the membership user from the membership data store.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ResetPassword() ResetPassword() ResetPassword() ResetPassword()

Restablece la contraseña de un usuario a una nueva generada automáticamente.Resets a user's password to a new, automatically generated password.

ResetPassword(String) ResetPassword(String) ResetPassword(String) ResetPassword(String)

Restablece la contraseña de un usuario a una nueva generada automáticamente.Resets a user's password to a new, automatically generated password.

ToString() ToString() ToString() ToString()

Devuelve el nombre de usuario correspondiente al usuario de pertenencia.Returns the user name for the membership user.

UnlockUser() UnlockUser() UnlockUser() UnlockUser()

Borra el estado de bloqueo del usuario para que se pueda validar el usuario de pertenencia.Clears the locked-out state of the user so that the membership user can be validated.

Se aplica a

Consulte también: