ActiveDirectoryMembershipUser Klasa

Definicja

Namespace:: System.Web.Security

Montaż:: System.Web.dll

Ważny

Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.

Uwidacznia i aktualizuje informacje o użytkowniku członkostwa przechowywane w magazynie danych usługi 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

Dziedziczenie: Object

MembershipUser
ActiveDirectoryMembershipUser

Atrybuty: SerializableAttribute

Przykłady

Poniższy przykład kodu przedstawia użycie właściwości obiektu na ActiveDirectoryMembershipUser stronie sieci Web, które mogą zwracać informacje o użytkowniku z wielu magazynów danych członkostwa. ActiveDirectoryMembershipUser Ponieważ obiekt, który poprzedza obiekt zwrócony przez dostawcę członkostwa, nie implementuje MembershipUser LastActivityDate właściwości iLastLoginDate, kod najpierw sprawdza typ obiektu użytkownika zwróconego od dostawcy członkostwa przed wyświetleniem zawartości tych właściwości.


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

Uwagi

Obiekt ActiveDirectoryMembershipUser jest używany do reprezentowania pojedynczego użytkownika członkostwa w magazynie danych członkostwa w usłudze Active Directory. Udostępnia on informacje o użytkowniku członkostwa, takim jak adres e-mail, i udostępnia funkcje dla użytkownika członkostwa, takie jak możliwość zmiany lub zresetowania hasła.

ActiveDirectoryMembershipUser Obiekt jest zwracany przez dostawcę członkostwa aplikacji za każdym razem, gdy aplikacja jest skonfigurowana do korzystania z magazynu danych usługi Active Directory. W aplikacji, która może być skonfigurowana do używania różnych magazynów danych lub w aplikacji korzystającej z wielu magazynów danych, można odwołać się do klasy bazowej . MembershipUser ActiveDirectoryMembershipUser Ponieważ obiekt nie implementuje LastActivityDate właściwości iLastLoginDate, należy przygotować się do obsługi NotSupportedException obiektu, który jest zgłaszany, gdy te elementy członkowskie są dostępne w ActiveDirectoryMembershipUser obiekcie.

Klasa ActiveDirectoryMembershipUser implementuje wewnętrzne optymalizacje używane przez klasę ActiveDirectoryMembershipProvider , aby zminimalizować liczbę aktualizacji atrybutów występujących podczas wywoływania UpdateUser metody. Serializuje również reprezentację SecurityIdentifier (dostępną we ProviderUserKey właściwości), aby ActiveDirectoryMembershipUser można było serializować i deserializować obiekt bez zgłaszania wyjątków.

ActiveDirectoryMembershipUser Obiekt jest zwracany przez GetUser metody i CreateUser lub w ramach MembershipUserCollection zwracanego przez GetAllUsersmetody , FindUsersByNamei FindUsersByEmail .

ActiveDirectoryMembershipUser Obiekt jest wymagany przez metodę UpdateUser , gdy chcesz zaktualizować informacje dla istniejącego użytkownika członkostwa.

ActiveDirectoryMembershipUser właściwości są mapowane na atrybuty usługi Active Directory. W poniższej tabeli wymieniono ActiveDirectoryMembershipUser właściwości i ich domyślne mapowania atrybutów.

Właściwość	Domyślny atrybut katalogu	Czy można mapować?
ProviderUserKey	`securityIdentifier`	Nie
UserName	`userPrincipalName`	Tak, ale musi mieć wartość userPrincipalName lub sAMAccountName
Comment	`comment`	Nie
CreationDate	`whenCreated`	Nie
Email	`mail`	Tak, ale musi być atrybutem jednowartościowym typu Unicode String.
LastActivityDate	n/d	Nieobsługiwane przez ActiveDirectoryMembershipProviderprogram .
LastLoginDate	n/d	Nieobsługiwane przez ActiveDirectoryMembershipProviderprogram .
LastPasswordChangedDate	`pwdLastSet`	Nie
PasswordQuestion	brak, ale musi być mapowany na atrybut, jeśli używasz zabezpieczeń pytań i odpowiedzi na potrzeby resetowania hasła lub pobierania.	Tak, ale musi być atrybutem jednowartościowym typu Unicode String.
IsApproved	`User-Account-Control` (AD) `mDS-UserAccountDisabled` (ADAM)	Nie
IsLockedOut	obliczony z `lockoutTime` czasu trwania blokady usługi AD (AD w systemie Windows 2000) `msDS-User-Account-Control-Computed` (AD w systemie Windows Server 2003) `msDS-User-Account-Control-Computed` (ADAM)	Nie
LastLockoutDate	Jeśli zablokowano z powodu zbyt wielu nieudanych prób hasła, zwracany jest atrybut czasu blokady. Jeśli zablokowano z powodu zbyt wielu nieudanych prób odpowiedzi na hasło, zwracana jest wartość przechowywana w atrybucie zdefiniowanym przez `attributeMapFailedPasswordAnswerLockoutTime` . Jeśli zablokowano z powodu nieprawidłowego hasła i zbyt wielu prób nieprawidłowego hasła, zwracana jest najnowsza wartość daty/godziny. Jeśli konto nie jest zablokowane, zwróć wartość 1/1/1753 w celu zapewnienia zgodności z programem SQL.	Nie

Konstruktorów

Nazwa	Opis
ActiveDirectoryMembershipUser()	Inicjuje ActiveDirectoryMembershipUser nowe wystąpienie obiektu dla klasy, która dziedziczy klasę ActiveDirectoryMembershipUser .
ActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)	Tworzy nowe wystąpienie ActiveDirectoryMembershipUser klasy z określonymi wartościami właściwości.

Właściwości

Nazwa	Opis
Comment	Pobiera lub ustawia informacje specyficzne dla aplikacji dla użytkownika członkostwa.
CreationDate	Pobiera datę i godzinę dodania użytkownika do magazynu danych członkostwa. (Dziedziczone od MembershipUser)
Email	Pobiera lub ustawia adres e-mail użytkownika członkostwa.
IsApproved	Pobiera lub ustawia wartość wskazującą, czy użytkownik członkowski może zostać uwierzytelniony.
IsLockedOut	Pobiera wartość wskazującą, czy użytkownik członkostwa jest zablokowany i nie można go zweryfikować. (Dziedziczone od MembershipUser)
IsOnline	Pobiera, czy użytkownik jest obecnie w trybie online. (Dziedziczone od MembershipUser)
LastActivityDate	NotSupportedException Zgłasza wyjątek we wszystkich przypadkach.
LastLockoutDate	Pobiera najnowszą datę i godzinę blokady użytkownika członkostwa. (Dziedziczone od MembershipUser)
LastLoginDate	NotSupportedException Zgłasza wyjątek we wszystkich przypadkach.
LastPasswordChangedDate	Pobiera datę i godzinę ostatniej aktualizacji hasła użytkownika członkostwa. (Dziedziczone od MembershipUser)
PasswordQuestion	Pobiera pytanie o hasło dla użytkownika członkostwa. (Dziedziczone od MembershipUser)
ProviderName	Pobiera nazwę dostawcy członkostwa, który przechowuje i pobiera informacje o użytkowniku członkostwa. (Dziedziczone od MembershipUser)
ProviderUserKey	Pobiera identyfikator użytkownika z magazynu danych usługi Active Directory dla użytkownika członkostwa.
UserName	Pobiera nazwę logowania użytkownika członkostwa. (Dziedziczone od MembershipUser)

Metody

Nazwa	Opis
ChangePassword(String, String)	Aktualizuje hasło użytkownika członkostwa w magazynie danych członkostwa. (Dziedziczone od MembershipUser)
ChangePasswordQuestionAndAnswer(String, String, String)	Aktualizuje pytanie i odpowiedź na hasło użytkownika członkostwa w magazynie danych członkostwa. (Dziedziczone od MembershipUser)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Dziedziczone od Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Dziedziczone od Object)
GetPassword()	Pobiera hasło użytkownika członkostwa z magazynu danych członkostwa. (Dziedziczone od MembershipUser)
GetPassword(String)	Pobiera hasło użytkownika członkostwa z magazynu danych członkostwa. (Dziedziczone od MembershipUser)
GetType()	Type Pobiera bieżące wystąpienie. (Dziedziczone od Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object)
ResetPassword()	Resetuje hasło użytkownika do nowego, automatycznie wygenerowanego hasła. (Dziedziczone od MembershipUser)
ResetPassword(String)	Resetuje hasło użytkownika do nowego, automatycznie wygenerowanego hasła. (Dziedziczone od MembershipUser)
ToString()	Zwraca nazwę użytkownika członkostwa. (Dziedziczone od MembershipUser)
UnlockUser()	Czyści zablokowany stan użytkownika, aby można było zweryfikować użytkownika członkostwa. (Dziedziczone od MembershipUser)

Dotyczy

Zobacz także

Wprowadzenie do członkostwa

Sprzężenie zwrotne

Czy ta strona była pomocna?