ActiveDirectoryMembershipUser Třída

Reference

Definice

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

Sestavení:: System.Web.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 členství uživatelů uložené v úložišti dat služby Active Directory.

public ref class ActiveDirectoryMembershipUser : System::Web::Security::MembershipUser

[System.Serializable]
public class ActiveDirectoryMembershipUser : System.Web.Security.MembershipUser

[<System.Serializable>]
type ActiveDirectoryMembershipUser = class
    inherit MembershipUser

Public Class ActiveDirectoryMembershipUser
Inherits MembershipUser

Dědičnost: Object

MembershipUser
ActiveDirectoryMembershipUser

Atributy: SerializableAttribute

Příklady

Následující příklad kódu ukazuje použití vlastností objektu ActiveDirectoryMembershipUser na webové stránce, které mohou vrátit informace o uživateli z více úložišť dat členství. ActiveDirectoryMembershipUser Protože objekt, který je základem objektu MembershipUser vráceného zprostředkovatelem členství, neimplementuje LastActivityDate vlastnosti a LastLoginDate , kód nejprve zkontroluje typ objektu uživatele vráceného zprostředkovatele členství před zobrazením obsahu těchto vlastností.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Page_Load(object sender, EventArgs e)
  {
    MembershipUser user =
        Membership.GetUser();

    userName.Text = user.UserName;
    emailAddress.Text = user.Email;

    // <Snippet2>
    if (user is ActiveDirectoryMembershipUser)
    {
      lastLoginDate.Text = "Not available";
      lastActivityDate.Text = "Not available";
    }
    else
    {
      lastLoginDate.Text = user.LastLoginDate.ToShortDateString();
      lastActivityDate.Text = user.LastActivityDate.ToShortDateString();
    }
    // </Snippet2>   
    
    // <Snippet3>
    System.Security.Principal.SecurityIdentifier sidValue =
      (System.Security.Principal.SecurityIdentifier)user.ProviderUserKey;

    sid.Text = sidValue.ToString();
    // </Snippet3>
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>User information</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td>
            User name:</td>
          <td>
            <asp:Literal ID="userName" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Email Address:</td>
          <td>
            <asp:Literal ID="emailAddress" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Login Date:</td>
          <td>
            <asp:Literal ID="lastLoginDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Activity Date:</td>
          <td>
            <asp:Literal ID="lastActivityDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Security Identifier SID:</td>
          <td>
            <asp:Literal ID="sid" runat="server" /></td>
        </tr>
      </table>
    </div>
  </form>
</body>
</html>


<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim user As MembershipUser = Membership.GetUser()
        
    userName.Text = user.UserName
    emailAddress.Text = user.Email
        
    ' <Snippet2>
    If TypeOf (user) Is ActiveDirectoryMembershipUser Then
      lastLoginDate.Text = "Not available"
      lastActivityDate.Text = "Not available"
    Else
      lastLoginDate.Text = user.LastLoginDate.ToString()
      lastActivityDate.Text = user.LastActivityDate.ToString()
    End If
    ' </Snippet2>
    
    ' <Snippet3>
    Dim sidValue As System.Security.Principal.SecurityIdentifier
    sidValue = CType(user.ProviderUserKey, System.Security.Principal.SecurityIdentifier)
    
    sid.Text = sidValue.ToString()
    ' </Snippet3>
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>User information page</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td>
            User name:</td>
          <td>
            <asp:Literal ID="userName" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Email Address:</td>
          <td>
            <asp:Literal ID="emailAddress" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Login Date:</td>
          <td>
            <asp:Literal ID="lastLoginDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Activity Date:</td>
          <td>
            <asp:Literal ID="lastActivityDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Security Identifier SID:</td>
          <td>
            <asp:Literal ID="sid" runat="server" /></td>
        </tr>
      </table>
    </div>
  </form>
</body>
</html>

Poznámky

Objekt ActiveDirectoryMembershipUser se používá k reprezentaci jednoho uživatele členství v úložišti dat členství služby Active Directory. Zveřejňuje informace o uživateli členství, jako je e-mailová adresa, a poskytuje mu funkce, jako je například možnost změnit nebo resetovat heslo.

ActiveDirectoryMembershipUser Zprostředkovatel členství aplikace vrátí objekt vždy, když je aplikace nakonfigurovaná tak, aby používala úložiště dat služby Active Directory. V aplikaci, kterou lze nakonfigurovat tak, aby používala různá úložiště dat, nebo v aplikaci, která používá více úložišť dat, můžete odkazovat na základní třídu MembershipUser. Vzhledem k tomu, ActiveDirectoryMembershipUser že objekt neimplementuje LastActivityDate vlastnosti a LastLoginDate , musíte být připraveni na zpracování NotSupportedException , která je vyvolána při přístupu k těmto členům objektu ActiveDirectoryMembershipUser .

Třída ActiveDirectoryMembershipUser implementuje interní optimalizace používané ActiveDirectoryMembershipProvider třídou k minimalizaci počtu aktualizací atributů, ke kterým dochází při volání UpdateUser metody . Také serializuje reprezentaci SecurityIdentifier (k dispozici ve ProviderUserKey vlastnosti), aby ActiveDirectoryMembershipUser bylo možné serializovat a deserializovat objekt bez vyvolání výjimek.

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

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

ActiveDirectoryMembershipUser vlastnosti se mapují na atributy služby Active Directory. Následující tabulka uvádí vlastnosti ActiveDirectoryMembershipUser a jejich výchozí mapování atributů.

Vlastnost	Výchozí atribut adresáře	Dá se mapovat?
ProviderUserKey	`securityIdentifier`	No
UserName	`userPrincipalName`	Ano, ale musí to být buď userPrincipalName, nebo sAMAccountName.
Comment	`comment`	No
CreationDate	`whenCreated`	No
Email	`mail`	Ano, ale musí se jednat o atribut s jednou hodnotou typu Řetězec unicode.
LastActivityDate	Není k dispozici	Nepodporuje .ActiveDirectoryMembershipProvider
LastLoginDate	Není k dispozici	Nepodporuje .ActiveDirectoryMembershipProvider
LastPasswordChangedDate	`pwdLastSet`	No
PasswordQuestion	žádný, ale musí být namapován na atribut, pokud pro resetování nebo načtení hesla používáte zabezpečení otázek a odpovědí.	Ano, ale musí se jednat o atribut s jednou hodnotou typu Řetězec unicode.
IsApproved	`User-Account-Control` (AD) `mDS-UserAccountDisabled` (Adam)	No
IsLockedOut	vypočítané z `lockoutTime` a doba trvání uzamčení SLUŽBY AD (AD ve Windows 2000) `msDS-User-Account-Control-Computed` (AD v systému Windows Server 2003) `msDS-User-Account-Control-Computed` (Adam)	No
LastLockoutDate	Pokud je uzamčený kvůli příliš velkému počtu neúspěšných pokusů o zadání hesla, vrátí se atribut lockout time ( čas uzamčení). Pokud je uzamčená kvůli příliš mnoha pokusům o odpověď na chybné heslo, vrátí se hodnota uložená v atributu definovaném uživatelem `attributeMapFailedPasswordAnswerLockoutTime` . Pokud je uzamčeno kvůli chybnému heslu i kvůli příliš velkému počtu neúspěšných pokusů o zadání hesla, vrátí se nejnovější hodnota data a času. Pokud účet není uzamčený, vraťte 1.1.1753 kvůli kompatibilitě SQL.	No

Konstruktory

ActiveDirectoryMembershipUser()	Inicializuje novou instanci objektu ActiveDirectoryMembershipUser pro třídu, která dědí ActiveDirectoryMembershipUser třídu .
ActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)	Vytvoří novou instanci ActiveDirectoryMembershipUser třídy se zadanými hodnotami vlastností.

Vlastnosti

Comment	Získá nebo nastaví informace specifické pro aplikaci uživatele členství.
CreationDate	Získá datum a čas, kdy byl uživatel přidán do úložiště dat členství. (Zděděno od MembershipUser)
Email	Získá nebo nastaví e-mailovou adresu člena uživatele.
IsApproved	Získá nebo nastaví hodnotu, která označuje, zda členství uživatele lze ověřit.
IsLockedOut	Získá hodnotu označující, zda je uživatel členství uzamčen a nelze ho ověřit. (Zděděno od MembershipUser)
IsOnline	Získá, zda je uživatel aktuálně online. (Zděděno od MembershipUser)
LastActivityDate	NotSupportedException Ve všech případech vyvolá výjimku.
LastLockoutDate	Získá nejnovější datum a čas, kdy byl uživatel členství uzamčen. (Zděděno od MembershipUser)
LastLoginDate	NotSupportedException Ve všech případech vyvolá výjimku.
LastPasswordChangedDate	Získá datum a čas poslední aktualizace hesla uživatele členství. (Zděděno od MembershipUser)
PasswordQuestion	Získá otázku hesla pro uživatele členství. (Zděděno od MembershipUser)
ProviderName	Získá název zprostředkovatele členství, který ukládá a načítá informace o uživateli členství. (Zděděno od MembershipUser)
ProviderUserKey	Získá identifikátor uživatele z úložiště dat služby Active Directory pro uživatele členství.
UserName	Získá přihlašovací jméno člena uživatele. (Zděděno od MembershipUser)

Metody

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

Platí pro

Viz také

Úvod do členství