MembershipUser Classe

Definizione

Espone e aggiorna le informazioni sugli utenti di appartenenza nell'archivio dei dati di appartenenza.

public ref class MembershipUser
[System.Serializable]
public class MembershipUser
[<System.Serializable>]
type MembershipUser = class
Public Class MembershipUser
Ereditarietà
MembershipUser
Derivato
Attributi

Esempio

Nell'esempio di codice seguente viene aggiornato l'indirizzo di posta elettronica per un utente.

Importante

Questo esempio contiene una casella di testo che accetta l'input utente, ovvero una potenziale minaccia di sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite 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>

Commenti

L'oggetto MembershipUser viene usato per rappresentare un singolo utente di appartenenza nell'archivio dati di appartenenza. Espone informazioni sull'utente di appartenenza, ad esempio l'indirizzo di posta elettronica, e fornisce funzionalità per l'utente dell'appartenenza, ad esempio la possibilità di modificare o reimpostare la password.

Nota

Se non si ha familiarità con le funzionalità di appartenenza di ASP.NET, vedere Introduzione all'appartenenza prima di continuare. Per un elenco di altri argomenti correlati all'appartenenza, vedere Gestione degli utenti tramite l'appartenenza.

Un MembershipUser oggetto viene restituito dai GetUser metodi e CreateUser o come parte di un MembershipUserCollection oggetto restituito dai GetAllUsersmetodi , FindUsersByNamee FindUsersByEmail .

Un MembershipUser oggetto è richiesto dal UpdateUser metodo quando si desidera aggiornare le informazioni per un utente di appartenenza esistente.

Costruttori

MembershipUser()

Crea una nuova istanza di un oggetto MembershipUser per una classe che eredita la classe MembershipUser.

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

Crea un nuovo oggetto utente di appartenenza con i valori di proprietà specificati.

Proprietà

Comment

Ottiene o imposta le informazioni specifiche dell'applicazione per l'utente di appartenenza.

CreationDate

Ottiene la data e l'ora in cui l'utente è stato aggiunto all'archivio dati di appartenenza.

Email

Ottiene o imposta l'indirizzo di posta elettronica per l'utente di appartenenza.

IsApproved

Ottiene o imposta un valore che indica se l'utente di appartenenza può essere autenticato.

IsLockedOut

Ottiene un valore che indica se l'utente di appartenenza è stato bloccato e quindi non è possibile convalidarlo.

IsOnline

Ottiene un valore che indica se l'utente è attualmente online.

LastActivityDate

Ottiene o imposta la data e ora dell'ultima autenticazione o dell'ultimo accesso all'applicazione dell'utente di appartenenza.

LastLockoutDate

Ottiene la data e l'ora più recenti in cui l'utente di appartenenza è stato bloccato.

LastLoginDate

Ottiene o imposta la data e l'ora dell'ultima autenticazione dell'utente.

LastPasswordChangedDate

Ottiene la data e l'ora dell'ultimo aggiornamento della password dell'utente di appartenenza.

PasswordQuestion

Ottiene la domanda segreta per l'utente di appartenenza.

ProviderName

Ottiene il nome del provider di appartenenze che archivia e recupera le informazioni utente per l'utente di appartenenza.

ProviderUserKey

Ottiene l'identificatore utente dall'origine dati di appartenenza dell'utente stesso.

UserName

Ottiene il nome di accesso dell'utente di appartenenza.

Metodi

ChangePassword(String, String)

Aggiorna la password per l'utente di appartenenza nell'archivio dati di appartenenza.

ChangePasswordQuestionAndAnswer(String, String, String)

Aggiorna la domanda e la risposta segreta per l'utente di appartenenza nell'archivio dati di appartenenza.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetPassword()

Ottiene la password per l'utente di appartenenza dall'archivio dati di appartenenza.

GetPassword(String)

Ottiene la password per l'utente di appartenenza dall'archivio dati di appartenenza.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ResetPassword()

Reimposta la password di un utente su una nuova password generata automaticamente.

ResetPassword(String)

Reimposta la password di un utente su una nuova password generata automaticamente.

ToString()

Restituisce il nome utente per l'utente di appartenenza.

UnlockUser()

Cancella lo stato di blocco dell'utente perché sia possibile convalidare l'utente di appartenenza.

Si applica a

Vedi anche