ActiveDirectoryMembershipUser Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.Security

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Konstruktory

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

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. (Odziedziczone po 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ć. (Odziedziczone po MembershipUser)
IsOnline	Pobiera, czy użytkownik jest obecnie w trybie online. (Odziedziczone po MembershipUser)
LastActivityDate	NotSupportedException Zgłasza wyjątek we wszystkich przypadkach.
LastLockoutDate	Pobiera najnowszą datę i godzinę blokady użytkownika członkostwa. (Odziedziczone po MembershipUser)
LastLoginDate	NotSupportedException Zgłasza wyjątek we wszystkich przypadkach.
LastPasswordChangedDate	Pobiera datę i godzinę ostatniej aktualizacji hasła użytkownika członkostwa. (Odziedziczone po MembershipUser)
PasswordQuestion	Pobiera pytanie o hasło dla użytkownika członkostwa. (Odziedziczone po MembershipUser)
ProviderName	Pobiera nazwę dostawcy członkostwa, który przechowuje i pobiera informacje o użytkowniku członkostwa. (Odziedziczone po 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. (Odziedziczone po MembershipUser)

Metody

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

Dotyczy

Zobacz też

Wprowadzenie do członkostwa

Udostępnij za pośrednictwem