MembershipUser Klasse

Referenz

Definition

Namespace:: System.Web.Security

Assembly:: System.Web.dll

Assembly:: System.Web.ApplicationServices.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Macht Mitgliedschaftsbenutzerinformationen im Mitgliedschaftsdatenspeicher verfügbar und aktualisiert diese.

public ref class MembershipUser

[System.Serializable]
public class MembershipUser

[<System.Serializable>]
type MembershipUser = class

Public Class MembershipUser

Vererbung: Object
MembershipUser

Abgeleitet: System.Web.Security.ActiveDirectoryMembershipUser

Attribute: SerializableAttribute

Beispiele

Im folgenden Codebeispiel wird die E-Mail-Adresse für einen Benutzer aktualisiert.

Wichtig

Dieses Beispiel enthält ein Textfeld, das Benutzereingaben akzeptiert, die eine potenzielle Sicherheitsrisiken darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.

<%@ 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>

Hinweise

Das MembershipUser Objekt wird verwendet, um einen einzelnen Mitgliedschaftsbenutzer im Mitgliedschaftsdatenspeicher darzustellen. Es stellt Informationen über den Mitgliedschaftsbenutzer wie die E-Mail-Adresse bereit und bietet Funktionen für den Mitgliedschaftsbenutzer, z. B. die Möglichkeit, ihr Kennwort zu ändern oder zurückzusetzen.

Hinweis

Wenn Sie nicht mit den Mitgliedschaftsfeatures von ASP.NET vertraut sind, lesen Sie die Einführung in die Mitgliedschaft, bevor Sie fortfahren. Eine Liste anderer Themen im Zusammenhang mit der Mitgliedschaft finden Sie unter Verwalten von Benutzern mithilfe der Mitgliedschaft.

Ein MembershipUser Objekt wird von den GetUser Methoden und CreateUser Methoden oder als Teil einer MembershipUserCollection von den GetAllUsersMethoden zurückgegebenen FindUsersByName, und FindUsersByEmail Methoden zurückgegeben.

Ein MembershipUser Objekt ist von der UpdateUser Methode erforderlich, wenn Sie die Informationen für einen vorhandenen Mitgliedschaftsbenutzer aktualisieren möchten.

Konstruktoren

MembershipUser()	Erstellt eine neue Instanz eines MembershipUser-Objekts für eine Klasse, die die MembershipUser-Klasse erbt.
MembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)	Erstellt ein neues Mitgliedschaftsbenutzerobjekt mit den angegebenen Eigenschaftswerten.

Eigenschaften

Comment	Ruft anwendungsspezifische Informationen für den Mitgliedschaftsbenutzer ab oder legt diese fest.
CreationDate	Ruft das Datum und die Uhrzeit der Hinzufügung des Benutzers zum Mitgliedschaftsdatenspeicher ab.
Email	Ruft die E-Mail-Adresse für den Mitgliedschaftsbenutzer ab oder legt sie fest.
IsApproved	Ruft ab oder legt fest, ob der Mitgliedschaftsbenutzer authentifiziert werden kann.
IsLockedOut	Ruft einen Wert ab, der angibt, ob der Mitgliedschaftsbenutzer gesperrt ist und nicht überprüft werden kann.
IsOnline	Ruft ab, ob der Benutzer derzeit online ist.
LastActivityDate	Ruft Datum und Uhrzeit der letzten Authentifizierung des Mitgliedschaftsbenutzers bzw. des letzten Zugriffs des Mitgliedschaftsbenutzers auf die Anwendung ab, oder legt diese Angabe fest.
LastLockoutDate	Ruft das Datum und die Uhrzeit der letzten Sperrung des Mitgliedschaftsbenutzers ab.
LastLoginDate	Ruft das Datum und die Uhrzeit der letzten Authentifizierung des Benutzers ab oder legt diese fest.
LastPasswordChangedDate	Ruft Datum und Uhrzeit der letzten Aktualisierung des Kennworts eines Mitgliedschaftsbenutzers ab.
PasswordQuestion	Ruft die Kennwortfrage für den Mitgliedschaftsbenutzer ab.
ProviderName	Ruft den Namen des Mitgliedschaftsanbieters ab, der Benutzerinformationen für den Mitgliedschaftsbenutzer abruft und speichert.
ProviderUserKey	Ruft die Benutzer-ID aus der Mitgliedschaftsdatenquelle für den Benutzer ab.
UserName	Ruft den Anmeldenamen des Mitgliedschaftsbenutzers ab.

Methoden

ChangePassword(String, String)	Aktualisiert das Kennwort für den Mitgliedschaftsbenutzer im Mitgliedschaftsdatenspeicher.
ChangePasswordQuestionAndAnswer(String, String, String)	Aktualisiert die Kennwortfrage und -antwort für den Mitgliedschaftsbenutzer im Mitgliedschaftsdatenspeicher.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetPassword()	Ruft das Kennwort für den Mitgliedschaftsbenutzer aus dem Mitgliedschaftsdatenspeicher ab.
GetPassword(String)	Ruft das Kennwort für den Mitgliedschaftsbenutzer aus dem Mitgliedschaftsdatenspeicher ab.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ResetPassword()	Setzt das Kennwort eines Benutzers auf ein neues, automatisch generiertes Kennwort zurück.
ResetPassword(String)	Setzt das Kennwort eines Benutzers auf ein neues, automatisch generiertes Kennwort zurück.
ToString()	Gibt den Benutzernamen für den Mitgliedschaftsbenutzer zurück.
UnlockUser()	Hebt die Sperre für den Benutzer auf, damit der Mitgliedschaftsbenutzer überprüft werden kann.

Gilt für

Siehe auch

Einführung in die Mitgliedschaft