MembershipUser Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.Security

Assembly:: System.Web.dll

Assembly:: System.Web.ApplicationServices.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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à: Object
MembershipUser

Derivato: System.Web.Security.ActiveDirectoryMembershipUser

Attributi: SerializableAttribute

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

Introduzione all'appartenenza

Condividi tramite