ActiveDirectoryMembershipUser Klass

Definition

Namnområde:: System.Web.Security

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Exponerar och uppdaterar användarinformation för medlemskap som lagras i ett služba Active Directory datalager.

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

Arv: Object

MembershipUser
ActiveDirectoryMembershipUser

Attribut: SerializableAttribute

Exempel

Följande kodexempel visar hur du använder egenskaper för ActiveDirectoryMembershipUser objektet på en webbsida som kan returnera användarinformation från flera medlemskapsdatalager. Eftersom objektet ActiveDirectoryMembershipUser som ligger till grund för MembershipUser objektet som returneras av medlemskapsprovidern inte implementerar LastActivityDate egenskaperna och LastLoginDate kontrollerar koden först typen av användarobjekt som returneras från medlemskapsprovidern innan innehållet i dessa egenskaper visas.


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

Kommentarer

Objektet ActiveDirectoryMembershipUser används för att representera en enskild medlemskapsanvändare i datalagret služba Active Directory medlemskap. Den visar information om medlemskapsanvändaren, till exempel e-postadressen, och tillhandahåller funktioner för medlemskapsanvändaren, till exempel möjligheten att ändra eller återställa sitt lösenord.

Ett ActiveDirectoryMembershipUser-objekt returneras av programmets medlemskapsprovider när programmet har konfigurerats för att använda ett služba Active Directory datalager. I ett program som kan konfigureras för att använda olika datalager, eller i ett program som använder flera datalager, kan du referera till basklassen . MembershipUser ActiveDirectoryMembershipUser Eftersom objektet inte implementerar LastActivityDate egenskaperna och LastLoginDate måste du vara beredd att hantera det NotSupportedException som genereras när dessa medlemmar används på ett ActiveDirectoryMembershipUser objekt.

Klassen ActiveDirectoryMembershipUser implementerar interna optimeringar som används av ActiveDirectoryMembershipProvider klassen för att minimera antalet attributuppdateringar som inträffar när metoden anropas UpdateUser . Den serialiserar även representationen SecurityIdentifier (tillgänglig i ProviderUserKey egenskapen) så att ett ActiveDirectoryMembershipUser objekt kan serialiseras och deserialiseras utan att utlösa undantag.

Ett ActiveDirectoryMembershipUser objekt returneras av GetUser metoderna och CreateUser eller som en del av ett MembershipUserCollection som returneras av GetAllUsersmetoderna , FindUsersByNameoch FindUsersByEmail .

Ett ActiveDirectoryMembershipUser objekt krävs av UpdateUser metoden när du vill uppdatera informationen för en befintlig medlemskapsanvändare.

ActiveDirectoryMembershipUser egenskaper mappas till služba Active Directory attribut. I följande tabell visas ActiveDirectoryMembershipUser egenskaperna och deras standardattributmappningar.

Fastighet	Standardkatalogattribut	Kan mappas?
ProviderUserKey	`securityIdentifier`	No
UserName	`userPrincipalName`	Ja, men måste vara antingen userPrincipalName eller sAMAccountName
Comment	`comment`	No
CreationDate	`whenCreated`	No
Email	`mail`	Ja, men måste vara ett envärdesattribut av typen Unicode String.
LastActivityDate	Inte tillämpligt	Stöds inte av ActiveDirectoryMembershipProvider.
LastLoginDate	Inte tillämpligt	Stöds inte av ActiveDirectoryMembershipProvider.
LastPasswordChangedDate	`pwdLastSet`	No
PasswordQuestion	ingen, men måste mappas till ett attribut om du använder säkerhet för frågor och svar för lösenordsåterställning eller hämtning.	Ja, men måste vara ett envärdesattribut av typen Unicode String.
IsApproved	`User-Account-Control` (AD) `mDS-UserAccountDisabled` (ADAM)	No
IsLockedOut	beräknas från `lockoutTime` och AD-utelåsningstiden (AD den Windows 2000) `msDS-User-Account-Control-Computed` (AD den Windows Server 2003) `msDS-User-Account-Control-Computed` (ADAM)	No
LastLockoutDate	Om det är utelåst på grund av för många felaktiga lösenordsförsök returneras tidsattributet för utelåsning. Om det är utelåst på grund av för många felaktiga lösenordssvar returneras värdet som lagras i attributet som definieras av `attributeMapFailedPasswordAnswerLockoutTime` . Om det är utelåst på grund av både ett felaktigt lösenord och för många felaktiga lösenordsförsök returneras det senaste datum-/tidsvärdet. Om kontot inte är utelåst returnerar du 1/1/1753 för SQL-kompatibilitet.	No

Konstruktorer

Name	Description
ActiveDirectoryMembershipUser()	Initierar en ny instans av ett ActiveDirectoryMembershipUser objekt för en klass som ärver ActiveDirectoryMembershipUser klassen.
ActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)	Skapar en ny instans av ActiveDirectoryMembershipUser klassen med de angivna egenskapsvärdena.

Egenskaper

Name	Description
Comment	Hämtar eller anger programspecifik information för medlemskapsanvändaren.
CreationDate	Hämtar datum och tid när användaren lades till i medlemskapsdatalagret. (Ärvd från MembershipUser)
Email	Hämtar eller anger e-postadressen för medlemskapsanvändaren.
IsApproved	Hämtar eller anger ett värde som anger om medlemskapsanvändaren kan autentiseras.
IsLockedOut	Hämtar ett värde som anger om medlemskapsanvändaren är utelåst och inte kan verifieras. (Ärvd från MembershipUser)
IsOnline	Hämtar om användaren är online för tillfället. (Ärvd från MembershipUser)
LastActivityDate	Genererar ett NotSupportedException undantag i alla fall.
LastLockoutDate	Hämtar det senaste datumet och den tid då medlemskapsanvändaren låstes ut. (Ärvd från MembershipUser)
LastLoginDate	Genererar ett NotSupportedException undantag i alla fall.
LastPasswordChangedDate	Hämtar datum och tid när medlemskapsanvändarens lösenord senast uppdaterades. (Ärvd från MembershipUser)
PasswordQuestion	Hämtar lösenordsfrågan för medlemskapsanvändaren. (Ärvd från MembershipUser)
ProviderName	Hämtar namnet på medlemskapsprovidern som lagrar och hämtar användarinformation för medlemskapsanvändaren. (Ärvd från MembershipUser)
ProviderUserKey	Hämtar användaridentifieraren från služba Active Directory datalager för medlemskapsanvändaren.
UserName	Hämtar inloggningsnamnet för medlemskapsanvändaren. (Ärvd från MembershipUser)

Metoder

Name	Description
ChangePassword(String, String)	Uppdaterar lösenordet för medlemskapsanvändaren i datalagret för medlemskap. (Ärvd från MembershipUser)
ChangePasswordQuestionAndAnswer(String, String, String)	Uppdaterar lösenordsfrågan och svaret för medlemskapsanvändaren i medlemskapsdatalagret. (Ärvd från MembershipUser)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetPassword()	Hämtar lösenordet för medlemskapsanvändaren från datalagret för medlemskap. (Ärvd från MembershipUser)
GetPassword(String)	Hämtar lösenordet för medlemskapsanvändaren från datalagret för medlemskap. (Ärvd från MembershipUser)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
ResetPassword()	Återställer en användares lösenord till ett nytt, automatiskt genererat lösenord. (Ärvd från MembershipUser)
ResetPassword(String)	Återställer en användares lösenord till ett nytt, automatiskt genererat lösenord. (Ärvd från MembershipUser)
ToString()	Returnerar användarnamnet för medlemskapsanvändaren. (Ärvd från MembershipUser)
UnlockUser()	Rensar användarens låsta tillstånd så att medlemskapsanvändaren kan verifieras. (Ärvd från MembershipUser)

Gäller för

Se även

Introduktion till medlemskap

Feedback

Var den här sidan till hjälp?