Classe MembershipUser (System.Web.Security)

Cambia visualizzazione:
Classica
Lightweight
ScriptFree
Riferimento a .NET Framework
Classe MembershipUser

Nota: questa classe è stata introdotta con .NET Framework versione 2.0.

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

Spazio dei nomi: System.Web.Security
Assembly: System.Web (in system.web.dll)

Sintassi
Visual Basic - (Dichiarazione)
<SerializableAttribute> _
Public Class MembershipUser
Visual Basic (Utilizzo)
Dim instance As MembershipUser
C#
[SerializableAttribute] 
public class MembershipUser
C++
[SerializableAttribute] 
public ref class MembershipUser
J#
/** @attribute SerializableAttribute() */ 
public class MembershipUser
JScript
SerializableAttribute 
public class MembershipUser
Note

L'oggetto MembershipUser è utilizzato per rappresentare un unico utente di appartenenza nell'archivio dati di appartenenze. Espone le informazioni sugli utenti di appartenenza, come ad esempio l'indirizzo di posta elettronica, e fornisce all'utente funzionalità quali la possibilità di cambiare o reimpostare la password.

Gli oggetti MembershipUser vengono restituiti mediante i metodi GetUser e CreateUser oppure come parte di un insieme MembershipUserCollection restituito dai metodi GetAllUsers, FindUsersByName e FindUsersByEmail.

Quando si desidera aggiornare le informazioni di un utente di appartenenza esistente è necessario fornire al metodo UpdateUser un oggetto MembershipUser.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come aggiornare l'indirizzo di posta elettronica di un utente.

Visual Basic
<%@ Page Language="vb" %>
<%@ Import Namespace="System.Web.Security" %>
<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 e-mail updated."
  Catch e As System.Configuration.Provider.ProviderException
    Msg.Text = e.Message
  End Try

End Sub

</script>
<html>
<head>
<title>Sample: Update User E-Mail</title>
</head>
<body>

<form 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>E-mail 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 E-mail" 
                      OnClick="UpdateEmailButton_OnClick" 
                      runat="server" /></td>
    </tr>
  </table>
</form>

</body>
</html>
C#
<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<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 e-mail updated.";
  }
  catch (System.Configuration.Provider.ProviderException e)
  {
    Msg.Text = e.Message;
  }
}

</script>
<html>
<head>
<title>Sample: Update User E-Mail</title>
</head>
<body>

<form 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>E-mail 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 E-mail" 
                      OnClick="UpdateEmailButton_OnClick" 
                      runat="server" /></td>
    </tr>
  </table>
</form>

</body>
</html>
Gerarchia di ereditarietà
System.Object
  System.Web.Security.MembershipUser
     System.Web.Security.ActiveDirectoryMembershipUser
Codice thread safe
I membri statici pubblici (Shared in Visual Basic) di questo tipo sono validi per le operazioni multithreading. I membri di istanza non sono garantiti come thread safe.
Piattaforme

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

Informazioni sulla versione

.NET Framework

Supportato in: 2.0
Vedere anche