Sdílet prostřednictvím

ActiveDirectoryMembershipUser Třída

  • Reference

Definice

Obor názvů:
System.Web.Security
Sestavení:
System.Web.dll

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čítání 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)

Aktualizuje heslo pro uživatele členství v úložišti dat členství.

(Zděděno od MembershipUser)
ChangePasswordQuestionAndAnswer(String, String, String)

Aktualizuje 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é