ActiveDirectoryMembershipUser Klas

Definitie

Naamruimte:
System.Web.Security
Assembly:
System.Web.dll

Hiermee worden gebruikersgegevens voor lidmaatschap weergegeven en bijgewerkt die zijn opgeslagen in een Active Directory gegevensarchief.

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
Overname
Object
MembershipUser
ActiveDirectoryMembershipUser
Kenmerken
SerializableAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u eigenschappen gebruikt voor het ActiveDirectoryMembershipUser object op een webpagina die gebruikersgegevens uit meerdere lidmaatschapsgegevensarchieven kan retourneren. Omdat het ActiveDirectoryMembershipUser object dat ten grondslag valt aan het MembershipUser object dat door de lidmaatschapsprovider wordt geretourneerd, de en LastActivityDate eigenschappen niet implementeertLastLoginDate, controleert de code eerst het type van het gebruikersobject dat is geretourneerd door de lidmaatschapsprovider voordat de inhoud van deze eigenschappen wordt weergegeven.


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

Opmerkingen

Het object ActiveDirectoryMembershipUser wordt gebruikt om één lidmaatschapsgebruiker in het Active Directory lidmaatschapsgegevensarchief weer te geven. Het bevat informatie over de lidmaatschapsgebruiker, zoals het e-mailadres, en biedt functionaliteit voor de lidmaatschapsgebruiker, zoals de mogelijkheid om hun wachtwoord te wijzigen of opnieuw in te stellen.

Een ActiveDirectoryMembershipUser-object wordt geretourneerd door de lidmaatschapsprovider van de toepassing wanneer de toepassing is geconfigureerd voor het gebruik van een Active Directory gegevensarchief. In een toepassing die kan worden geconfigureerd voor het gebruik van verschillende gegevensarchieven of in een toepassing die gebruikmaakt van meerdere gegevensarchieven, kunt u verwijzen naar de basisklasse. MembershipUser Omdat het ActiveDirectoryMembershipUser object de LastActivityDate en LastLoginDate eigenschappen niet implementeert, moet u voorbereid zijn op de NotSupportedException verwerking die wordt gegenereerd wanneer deze leden worden geopend op een ActiveDirectoryMembershipUser object.

De ActiveDirectoryMembershipUser klasse implementeert interne optimalisaties die door de ActiveDirectoryMembershipProvider klasse worden gebruikt om het aantal kenmerkupdates te minimaliseren dat optreedt bij het aanroepen van de UpdateUser methode. Het serialiseert ook de SecurityIdentifier weergave (beschikbaar in de ProviderUserKey eigenschap) zodat een ActiveDirectoryMembershipUser object kan worden geserialiseerd en gedeserialiseerd zonder uitzonderingen te genereren.

Een ActiveDirectoryMembershipUser object wordt geretourneerd door de GetUser en CreateUser methoden of als onderdeel van een MembershipUserCollection geretourneerd door de GetAllUsers, FindUsersByNameen FindUsersByEmail methoden.

Een ActiveDirectoryMembershipUser object is vereist voor de UpdateUser methode wanneer u de informatie voor een bestaande lidmaatschapsgebruiker wilt bijwerken.

ActiveDirectoryMembershipUser eigenschappen worden toegewezen aan Active Directory kenmerken. De volgende tabel bevat de ActiveDirectoryMembershipUser eigenschappen en de bijbehorende standaardkenmerktoewijzingen.

Vastgoed Standaardmapkenmerk Kan worden toegewezen?
ProviderUserKey securityIdentifier No
UserName userPrincipalName Ja, maar moet userPrincipalName of sAMAccountName zijn
Comment comment No
CreationDate whenCreated No
Email mail Ja, maar moet een kenmerk met één waarde van het type Unicode-tekenreeks zijn.
LastActivityDate n.v.t. Niet ondersteund door ActiveDirectoryMembershipProvider.
LastLoginDate n.v.t. Niet ondersteund door ActiveDirectoryMembershipProvider.
LastPasswordChangedDate pwdLastSet No
PasswordQuestion geen, maar moet worden toegewezen aan een kenmerk als u de vraag-en-antwoordbeveiliging gebruikt voor het opnieuw instellen of ophalen van wachtwoorden. Ja, maar moet een kenmerk met één waarde van het type Unicode-tekenreeks zijn.
IsApproved User-Account-Control (AD)

mDS-UserAccountDisabled (ADAM)		 No
IsLockedOut berekend op basis van lockoutTime en de duur van de AD-vergrendeling (AD op Windows 2000)

msDS-User-Account-Control-Computed (AD op Windows Server 2003)

msDS-User-Account-Control-Computed (ADAM)		 No
LastLockoutDate Als deze is vergrendeld vanwege te veel mislukte wachtwoordpogingen, wordt het kenmerk vergrendelingstijd geretourneerd.

Als deze is vergrendeld vanwege te veel mislukte wachtwoordantwoordpogingen, wordt de waarde die is opgeslagen in het kenmerk dat is attributeMapFailedPasswordAnswerLockoutTime gedefinieerd, geretourneerd.

Als deze optie is vergrendeld vanwege een ongeldig wachtwoord en te veel mislukte wachtwoordpogingen, wordt de meest recente datum/tijd-waarde geretourneerd.

Als het account niet is vergrendeld, retourneert u 1-1-1753 voor SQL-compatibiliteit.		 No

Constructors

Name Description
ActiveDirectoryMembershipUser()

Initialiseert een nieuw exemplaar van een ActiveDirectoryMembershipUser object voor een klasse die de ActiveDirectoryMembershipUser klasse over neemt.
ActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)

Hiermee maakt u een nieuw exemplaar van de ActiveDirectoryMembershipUser klasse met de opgegeven eigenschapswaarden.

Eigenschappen

Name Description
Comment

Hiermee wordt toepassingsspecifieke informatie opgehaald of ingesteld voor de lidmaatschapsgebruiker.
CreationDate

Hiermee wordt de datum en tijd opgehaald waarop de gebruiker is toegevoegd aan het lidmaatschapsgegevensarchief.

(Overgenomen van MembershipUser)
Email

Hiermee haalt u het e-mailadres van de lidmaatschapsgebruiker op of stelt u dit in.
IsApproved

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de lidmaatschapsgebruiker kan worden geverifieerd.
IsLockedOut

Hiermee wordt een waarde opgehaald die aangeeft of de lidmaatschapsgebruiker is vergrendeld en niet kan worden gevalideerd.

(Overgenomen van MembershipUser)
IsOnline

Hiermee wordt aangegeven of de gebruiker momenteel online is.

(Overgenomen van MembershipUser)
LastActivityDate

Genereert in alle gevallen een NotSupportedException uitzondering.
LastLockoutDate

Hiermee wordt de meest recente datum en tijd opgehaald waarop de lidmaatschapsgebruiker is vergrendeld.

(Overgenomen van MembershipUser)
LastLoginDate

Genereert in alle gevallen een NotSupportedException uitzondering.
LastPasswordChangedDate

Hiermee wordt de datum en tijd opgehaald waarop het wachtwoord van de gebruiker voor het lidmaatschap voor het laatst is bijgewerkt.

(Overgenomen van MembershipUser)
PasswordQuestion

Hiermee haalt u de wachtwoordvraag voor de lidmaatschapsgebruiker op.

(Overgenomen van MembershipUser)
ProviderName

Hiermee haalt u de naam op van de lidmaatschapsprovider die gebruikersgegevens voor de lidmaatschapsgebruiker opslaat en ophaalt.

(Overgenomen van MembershipUser)
ProviderUserKey

Hiermee haalt u de gebruikers-id op uit het Active Directory gegevensarchief voor de lidmaatschapsgebruiker.
UserName

Hiermee haalt u de aanmeldingsnaam van de lidmaatschapsgebruiker op.

(Overgenomen van MembershipUser)

Methoden

Name Description
ChangePassword(String, String)

Hiermee wordt het wachtwoord bijgewerkt voor de lidmaatschapsgebruiker in het lidmaatschapsgegevensarchief.

(Overgenomen van MembershipUser)
ChangePasswordQuestionAndAnswer(String, String, String)

Hiermee werkt u de wachtwoordvraag en het antwoord voor de lidmaatschapsgebruiker in het lidmaatschapsgegevensarchief bij.

(Overgenomen van MembershipUser)
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetPassword()

Hiermee haalt u het wachtwoord voor de lidmaatschapsgebruiker op uit het lidmaatschapsgegevensarchief.

(Overgenomen van MembershipUser)
GetPassword(String)

Hiermee haalt u het wachtwoord voor de lidmaatschapsgebruiker op uit het lidmaatschapsgegevensarchief.

(Overgenomen van MembershipUser)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
ResetPassword()

Hiermee stelt u het wachtwoord van een gebruiker opnieuw in op een nieuw, automatisch gegenereerd wachtwoord.

(Overgenomen van MembershipUser)
ResetPassword(String)

Hiermee stelt u het wachtwoord van een gebruiker opnieuw in op een nieuw, automatisch gegenereerd wachtwoord.

(Overgenomen van MembershipUser)
ToString()

Retourneert de gebruikersnaam voor de lidmaatschapsgebruiker.

(Overgenomen van MembershipUser)
UnlockUser()

Hiermee wist u de vergrendelde status van de gebruiker, zodat de lidmaatschapsgebruiker kan worden gevalideerd.

(Overgenomen van MembershipUser)

Van toepassing op

Zie ook