MembershipUser Třída

Reference

Definice

Obor názvů:: System.Web.Security

Sestavení:: System.Web.dll

Sestavení:: System.Web.ApplicationServices.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zveřejňuje a aktualizuje informace o uživateli členství v úložišti dat členství.

public ref class MembershipUser

[System.Serializable]
public class MembershipUser

[<System.Serializable>]
type MembershipUser = class

Public Class MembershipUser

Dědičnost: Object
MembershipUser

Odvozené: System.Web.Security.ActiveDirectoryMembershipUser

Atributy: SerializableAttribute

Příklady

Následující příklad kódu aktualizuje e-mailovou adresu uživatele.

Důležité

Tento příklad obsahuje textové pole, které přijímá uživatelský vstup, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že vstup uživatele neobsahuje skripty ani elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.

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

Poznámky

Objekt MembershipUser se používá k reprezentaci jednoho uživatele členství v úložišti dat členství. Zveřejňuje informace o uživateli členství, například e-mailovou adresu, a poskytuje funkce pro uživatele členství, jako je například možnost změnit nebo resetovat heslo.

Poznámka

Pokud nejste obeznámeni s funkcemi členství ASP.NET, přečtěte si téma Úvod k členství, než budete pokračovat. Seznam dalších témat souvisejících s členstvím najdete v tématu Správa uživatelů pomocí členství.

Objekt MembershipUser je vrácen metodami GetUser a CreateUser metodami nebo jako součást MembershipUserCollection vrácených metodou GetAllUsers, FindUsersByNamea FindUsersByEmail metody.

Objekt MembershipUser je vyžadován metodou UpdateUser , pokud chcete aktualizovat informace pro existujícího uživatele členství.

Konstruktory

MembershipUser()	Vytvoří novou instanci objektu MembershipUser pro třídu, která dědí MembershipUser třídu.
MembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)	Vytvoří nový objekt uživatele členství se zadanými hodnotami vlastností.

Vlastnosti

Comment	Získá nebo nastaví informace specifické pro aplikaci pro uživatele členství.
CreationDate	Získá datum a čas, kdy byl uživatel přidán do úložiště dat členství.
Email	Získá nebo nastaví e-mailovou adresu pro uživatele členství.
IsApproved	Získá nebo nastaví, zda je možné ověřit uživatele členství.
IsLockedOut	Získá hodnotu určující, zda je uživatel členství uzamčen a nelze ověřit.
IsOnline	Získá, jestli je uživatel aktuálně online.
LastActivityDate	Získá nebo nastaví datum a čas, kdy byl uživatel členství naposledy ověřen nebo získal přístup k aplikaci.
LastLockoutDate	Získá nejnovější datum a čas, kdy byl uživatel členství uzamčen.
LastLoginDate	Získá nebo nastaví datum a čas posledního ověření uživatele.
LastPasswordChangedDate	Získá datum a čas poslední aktualizace hesla uživatele členství.
PasswordQuestion	Získá dotaz na heslo pro uživatele členství.
ProviderName	Získá název zprostředkovatele členství, který ukládá a načítá informace o uživateli členství.
ProviderUserKey	Získá identifikátor uživatele ze zdroje dat členství pro uživatele.
UserName	Získá přihlašovací jméno uživatele členství.

Metody

ChangePassword(String, String)	Aktualizuje heslo pro uživatele členství v úložišti dat členství.
ChangePasswordQuestionAndAnswer(String, String, String)	Aktualizuje otázku hesla a odpověď pro uživatele členství v úložišti dat členství.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetPassword()	Získá heslo pro uživatele členství z úložiště dat členství.
GetPassword(String)	Získá heslo pro uživatele členství z úložiště dat členství.
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
ResetPassword()	Resetuje heslo uživatele na nové, automaticky generované heslo.
ResetPassword(String)	Resetuje heslo uživatele na nové, automaticky generované heslo.
ToString()	Vrátí uživatelské jméno pro uživatele členství.
UnlockUser()	Vymaže uzamčený stav uživatele, aby bylo možné ověřit uživatele členství.

Platí pro

Viz také

Úvod do členství