SqlMembershipProvider.UpdateUser(MembershipUser) Méthode
Définition
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.
Met à jour des informations sur un utilisateur dans la base de données d’appartenance SQL Server.
public:
override void UpdateUser(System::Web::Security::MembershipUser ^ user);public override void UpdateUser(System.Web.Security.MembershipUser user);override this.UpdateUser : System.Web.Security.MembershipUser -> unitPublic Overrides Sub UpdateUser (user As MembershipUser)Paramètres
- user
- MembershipUser
Objet MembershipUser qui représente l’utilisateur à mettre à jour et les informations mises à jour pour l’utilisateur.
Exceptions
user a la valeur null.
- ou -
La UserName propriété de user est null.
- ou -
La Email propriété de l’objet user est null définie RequiresUniqueEmail sur true.
La UserName propriété d’une user chaîne vide (« »), contient une virgule, ou est supérieure à 256 caractères.
- ou -
La Email propriété de plus de user 256 caractères est supérieure à 256 caractères.
- ou -
La Email propriété d’une user chaîne vide est RequiresUniqueEmail définie sur true.
La UserName propriété de la base de user données n’a pas été trouvée.
- ou -
La Email propriété d’une user adresse e-mail existante dans la base de données RequiresUniqueEmail est définie sur true.
- ou -
Échec de la mise à jour de l’utilisateur.
Exemples
L’exemple de code suivant met à jour l’adresse e-mail d’un utilisateur.
Note
Cet exemple utilise la Membership classe pour appeler le SqlMembershipProvider fichier spécifié en tant que defaultProvider fichier Web.config. Si vous devez accéder au fournisseur par défaut en tant que type SqlMembershipProvider, vous pouvez caster la Provider propriété de la Membership classe. Pour accéder à d’autres fournisseurs configurés en tant que type de fournisseur spécifique, vous pouvez y accéder par leur nom configuré avec la Providers propriété de la Membership classe et les convertir en tant que type de fournisseur spécifique.
<%@ 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
Cette méthode est appelée par la Membership classe pour mettre à jour les informations utilisateur d’un utilisateur dans la base de données SQL Server spécifiée dans le fichier de configuration de l’application ASP.NET (Web.config). Les Emailvaleurs , , LastLoginDateCommentIsApprovedet LastActivityDate les valeurs de propriété sont mises à jour pour l’utilisateur d’appartenance spécifié.
La longueur maximale de la UserName propriété est de 256 caractères. La longueur maximale de la Email propriété est de 256 caractères.
Le mot de passe d’un utilisateur d’appartenance ne peut pas être mis à jour à l’aide de la UpdateUser méthode. Pour mettre à jour le mot de passe d’un utilisateur d’appartenance, utilisez la ChangePassword méthode de la MembershipUser classe.
