MembershipUser Classe

Référence

Définition

Espace de noms:: System.Web.Security

Assembly:: System.Web.dll

Assembly:: System.Web.ApplicationServices.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Expose et met à jour les informations utilisateur d’appartenance dans le magasin de données d’appartenance.

public ref class MembershipUser

[System.Serializable]
public class MembershipUser

[<System.Serializable>]
type MembershipUser = class

Public Class MembershipUser

Héritage: Object
MembershipUser

Dérivé: System.Web.Security.ActiveDirectoryMembershipUser

Attributs: SerializableAttribute

Exemples

L’exemple de code suivant met à jour l’adresse e-mail d’un utilisateur.

Important

Cet exemple contient une zone de texte qui accepte l’entrée utilisateur, qui est une menace de sécurité potentielle. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques 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>

Remarques

L’objet MembershipUser est utilisé pour représenter un utilisateur d’appartenance unique dans le magasin de données d’appartenance. Il expose des informations sur l’utilisateur d’appartenance tel que l’adresse e-mail et fournit des fonctionnalités pour l’utilisateur d’appartenance, telles que la possibilité de modifier ou de réinitialiser son mot de passe.

Notes

Si vous n’êtes pas familiarisé avec les fonctionnalités d’adhésion de ASP.NET, consultez Présentation de l’appartenance avant de continuer. Pour obtenir la liste des autres rubriques relatives à l’appartenance, consultez Gestion des utilisateurs à l’aide de l’appartenance.

Un MembershipUser objet est retourné par les GetUser méthodes et CreateUser les méthodes ou dans le cadre d’un MembershipUserCollection retour par les GetAllUsersméthodes , FindUsersByNameet FindUsersByEmail les méthodes.

Un MembershipUser objet est requis par la UpdateUser méthode lorsque vous souhaitez mettre à jour les informations d’un utilisateur d’appartenance existant.

Constructeurs

MembershipUser()	Crée une instance d’un objet MembershipUser pour une classe qui hérite de la classe MembershipUser.
MembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)	Crée un objet utilisateur d’appartenance avec les valeurs de propriétés spécifiées.

Propriétés

Comment	Obtient ou définit des informations propres à l’application pour l’utilisateur d’appartenance.
CreationDate	Obtient la date et l’heure d’ajout de l’utilisateur au magasin de données d’appartenance.
Email	Obtient ou définit l’adresse e-mail de l’utilisateur d’appartenance.
IsApproved	Obtient ou définit une valeur indiquant si l’utilisateur d’appartenance peut être authentifié.
IsLockedOut	Obtient une valeur indiquant si l’utilisateur d’appartenance est verrouillé et impossible à valider.
IsOnline	Détermine si l’utilisateur est actuellement en ligne.
LastActivityDate	Obtient ou définit la date et l’heure auxquelles l’utilisateur d’appartenance a été authentifié ou a accédé à l’application pour la dernière fois.
LastLockoutDate	Obtient la date et l’heure du dernier verrouillage de l’utilisateur d’appartenance.
LastLoginDate	Obtient ou définit la date et l’heure de dernière authentification de l’utilisateur.
LastPasswordChangedDate	Obtient la date et l’heure de la dernière mise à jour du mot de passe de l’utilisateur d’appartenance.
PasswordQuestion	Obtient la question du mot de passe pour l’utilisateur d’appartenance.
ProviderName	Obtient le nom du fournisseur d’appartenances qui stocke et récupère les informations utilisateur pour l’utilisateur d’appartenance.
ProviderUserKey	Obtient l’identificateur d’utilisateur à partir de la source de données d’appartenance de l’utilisateur.
UserName	Obtient le nom de connexion de l’utilisateur d’appartenance.

Méthodes

ChangePassword(String, String)	Met à jour le mot de passe pour l’utilisateur d’appartenance dans le magasin de données d’appartenance.
ChangePasswordQuestionAndAnswer(String, String, String)	Met à jour la question et la réponse de mot de passe pour l’utilisateur d’appartenance (membership user) dans le magasin de données d’appartenance.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetPassword()	Obtient le mot de passe pour l’utilisateur d’appartenance dans le magasin de données d’appartenance.
GetPassword(String)	Obtient le mot de passe pour l’utilisateur d’appartenance dans le magasin de données d’appartenance.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ResetPassword()	Réinitialise le mot de passe d’un utilisateur et affecte un nouveau mot de passe généré automatiquement.
ResetPassword(String)	Réinitialise le mot de passe d’un utilisateur et affecte un nouveau mot de passe généré automatiquement.
ToString()	Retourne le nom d’utilisateur de l’utilisateur d’appartenance.
UnlockUser()	Efface l’état verrouillé de l’utilisateur pour que l’utilisateur d’appartenance puisse être validé.

S’applique à

Voir aussi

Présentation de l’appartenance