ActiveDirectoryMembershipUser Třída

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 uživatelích členství uložených 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 Vzhledem k tomu, že objekt, který je základem MembershipUser objekt vrácený poskytovatelem členství, neimplementuje LastActivityDate a LastLoginDate vlastnosti, kód nejprve zkontroluje typ objektu uživatele vráceného poskytovatelem č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 funkce pro uživatele členství, jako je možnost změnit nebo resetovat heslo.

Objekt ActiveDirectoryMembershipUser je vrácen poskytovatelem členství aplikace pokaždé, když je aplikace nakonfigurovaná tak, aby používala úložiště dat služby Active Directory. V aplikaci, která 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, že ActiveDirectoryMembershipUser objekt neimplementuje LastActivityDate a LastLoginDate vlastnosti, musíte být připraveni zpracovat NotSupportedException , který je vyvolán při přístupu těchto členů k 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 objekt lze serializovat a deserializovat bez vyvolání výjimek.

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

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

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

Vlastnictví	Výchozí atribut adresáře	Je možné mapovat?
ProviderUserKey	`securityIdentifier`	Ne
UserName	`userPrincipalName`	Ano, ale musí to být userPrincipalName nebo sAMAccountName.
Comment	`comment`	Ne
CreationDate	`whenCreated`	Ne
Email	`mail`	Ano, ale musí to být atribut typu Unicode String s jednou hodnotou.
LastActivityDate	není k dispozici	ActiveDirectoryMembershipProviderNepodporuje .
LastLoginDate	není k dispozici	ActiveDirectoryMembershipProviderNepodporuje .
LastPasswordChangedDate	`pwdLastSet`	Ne
PasswordQuestion	žádný, ale musí být namapován na atribut, pokud používáte zabezpečení otázek a odpovědí pro resetování nebo načítání hesla.	Ano, ale musí to být atribut typu Unicode String s jednou hodnotou.
IsApproved	`User-Account-Control` (AD) `mDS-UserAccountDisabled` (ADAM)	Ne
IsLockedOut	vypočítaná z `lockoutTime` a doba trvání uzamčení AD (AD ve Windows 2000) `msDS-User-Account-Control-Computed` (AD v systému Windows Server 2003) `msDS-User-Account-Control-Computed` (ADAM)	Ne
LastLockoutDate	Pokud je uzamčeno kvůli příliš mnoha pokusům o zadání hesla, vrátí se atribut doby uzamčení. Pokud je uzamčeno kvůli příliš mnoha pokusům o odpověď na heslo, vrátí se hodnota uložená v atributu definovaném uživatelem `attributeMapFailedPasswordAnswerLockoutTime` . Pokud je uzamčeno kvůli chybnému heslu i příliš mnoha pokusům 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.	Ne

Konstruktory

Name	Description
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 vlastnosti.

Vlastnosti

Name	Description
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í. (Zděděno od MembershipUser)
Email	Získá nebo nastaví e-mailovou adresu uživatele členství.
IsApproved	Získá nebo nastaví hodnotu, která označuje, zda může být uživatel členství ověřen.
IsLockedOut	Získá hodnotu určující, zda je uživatel členství uzamčen a nelze ověřit. (Zděděno od MembershipUser)
IsOnline	Získá, zda je uživatel aktuálně online. (Zděděno od MembershipUser)
LastActivityDate	NotSupportedException Vyvolá výjimku ve všech případech.
LastLockoutDate	Získá nejnovější datum a čas, kdy byl uživatel členství uzamčen. (Zděděno od MembershipUser)
LastLoginDate	NotSupportedException Vyvolá výjimku ve všech případech.
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 uživatele členství. (Zděděno od MembershipUser)

Metody

Name	Description
ChangePassword(String, String)	Aktualizuje heslo pro uživatele členství v úložišti dat členství. (Zděděno od MembershipUser)
ChangePasswordQuestionAndAnswer(String, String, String)	Aktualizuje otázku hesla a odpověď pro uživatele členství v úložišti dat členství. (Zděděno od MembershipUser)
Equals(Object)	Určuje, zda je zadaný objekt roven 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í. (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()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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 uživatele členství. (Zděděno od MembershipUser)
UnlockUser()	Vymaže uzamčený stav uživatele, aby bylo možné ověřit uživatele členství. (Zděděno od MembershipUser)

Platí pro

Viz také

Úvod do členství

Váš názor

Byla tato stránka užitečná?