ActiveDirectoryMembershipUser 클래스

정의

Active Directory 데이터 저장소에 저장된 멤버 자격 사용자 정보를 노출 및 업데이트합니다.Exposes and updates membership user information stored in an Active Directory data store.

public ref class ActiveDirectoryMembershipUser : System::Web::Security::MembershipUser
[System.Serializable]
public class ActiveDirectoryMembershipUser : System.Web.Security.MembershipUser
type ActiveDirectoryMembershipUser = class
    inherit MembershipUser
Public Class ActiveDirectoryMembershipUser
Inherits MembershipUser
상속
ActiveDirectoryMembershipUser
특성

예제

다음 코드 예제에서 속성을 사용 하는 방법을 보여 줍니다는 ActiveDirectoryMembershipUser 여러 멤버 자격 데이터 저장소에서 사용자 정보를 반환할 수 있는 웹 페이지에는 개체입니다.The following code example demonstrates using properties on the ActiveDirectoryMembershipUser object on a Web page that may return user information from multiple membership data stores. 때문에 합니다 ActiveDirectoryMembershipUser 개체의 기반이 되는 MembershipUser 멤버 자격 공급자에서 반환 된 개체를 구현 하지 않습니다는 LastActivityDateLastLoginDate 속성 코드 멤버 자격에서 반환 되는 사용자 개체의 형식을 먼저 확인 이러한 속성의 내용을 표시 하기 전에 공급자입니다.Because the ActiveDirectoryMembershipUser object that underlies the MembershipUser object returned by the membership provider does not implement the LastActivityDate and LastLoginDate properties, the code first checks the type of the user object returned from the membership provider before displaying the contents of those properties.


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

설명

ActiveDirectoryMembershipUser 개체는 Active Directory 구성원 자격 데이터 저장소의 단일 멤버 자격 사용자를 나타내는 데 사용 됩니다.The ActiveDirectoryMembershipUser object is used to represent a single membership user in the Active Directory membership data store. 전자 메일 주소와 같은 멤버 자격 사용자에 대 한 정보를 노출 하 고 변경 하거나 자신의 암호를 재설정 하는 기능과 같은 멤버 자격 사용자에 대 한 기능을 제공 합니다.It exposes information about the membership user such as the email address, and provides functionality for the membership user such as the ability to change or reset his or her password.

ActiveDirectoryMembershipUser 때마다 애플리케이션을 Active Directory 데이터 저장소를 사용 하도록 구성 된 애플리케이션의 멤버 자격 공급자 개체를 반환 합니다.An ActiveDirectoryMembershipUser object is returned by the application's membership provider whenever the application is configured to use an Active Directory data store. 구성할 수 있는 애플리케이션에서 다른 데이터를 사용 하 여 저장소로, 또는 여러 데이터 저장소를 사용 하는 애플리케이션에서 기본 클래스를 참조할 수 있습니다 MembershipUser합니다.In an application that can be configured to use different data stores, or in an application that uses multiple data stores, you can refer to the base class, MembershipUser. 때문에 ActiveDirectoryMembershipUser 개체를 구현 하지 않습니다는 LastActivityDateLastLoginDate 속성을 준비 해야 처리 하는 NotSupportedException 이러한 멤버에 액세스 하는 경우 throw 되는 ActiveDirectoryMembershipUser 개체입니다.Because the ActiveDirectoryMembershipUser object does not implement the LastActivityDate and LastLoginDate properties, you must be prepared to handle the NotSupportedException that is thrown when these members are accessed on an ActiveDirectoryMembershipUser object.

ActiveDirectoryMembershipUser 에서 사용 하는 내부 최적화를 구현 하는 클래스를 ActiveDirectoryMembershipProvider 클래스를 호출할 때 발생 하는 특성 업데이트의 수를 최소화 하는 UpdateUser 메서드.The ActiveDirectoryMembershipUser class implements internal optimizations used by the ActiveDirectoryMembershipProvider class to minimize the number of attribute updates that occur when calling the UpdateUser method. 또한 serialize를 SecurityIdentifier 표현 (에서 사용할 수 있는 ProviderUserKey 속성) 있도록는 ActiveDirectoryMembershipUser 개체를 직렬화 및 예외를 throw 하지 않고 역직렬화 할 수 있습니다.It also serializes the SecurityIdentifier representation (available in the ProviderUserKey property) so that an ActiveDirectoryMembershipUser object can be serialized and deserialized without throwing exceptions.

ActiveDirectoryMembershipUser 개체를 반환 합니다 GetUserCreateUser 메서드 또는 일부로 MembershipUserCollection 반환한를 GetAllUsers, FindUsersByName, 및 FindUsersByEmail 메서드.A ActiveDirectoryMembershipUser object is returned by the GetUser and CreateUser methods or as part of a MembershipUserCollection returned by the GetAllUsers, FindUsersByName, and FindUsersByEmail methods.

ActiveDirectoryMembershipUser 개체에 필요한 여 UpdateUser 메서드는 기존 멤버 자격 사용자에 대 한 정보를 업데이트 하려는 경우.An ActiveDirectoryMembershipUser object is required by the UpdateUser method when you want to update the information for an existing membership user.

ActiveDirectoryMembershipUser 속성은 Active Directory 특성에 매핑됩니다.ActiveDirectoryMembershipUser properties are mapped to Active Directory attributes. 다음 표에서 ActiveDirectoryMembershipUser 속성 및 해당 기본 특성 매핑.The following table lists the ActiveDirectoryMembershipUser properties and their default attribute mappings.

속성Property 기본 디렉터리 특성Default directory attribute 매핑할 수 있습니다.Can be mapped?
ProviderUserKey securityIdentifier 아니요No
UserName userPrincipalName 예, 하지만 userPrincipalName 또는 sAMAccountName 여야 합니다Yes, but must be either userPrincipalName or sAMAccountName
Comment comment 아니요No
CreationDate whenCreated 아니요No
Email mail 예, 하지만 유니코드 문자열 형식의 단일 값 특성 이어야 합니다.Yes, but must be a single-valued attribute of type Unicode String.
LastActivityDate 해당 없음n/a 지원 되지 않습니다 ActiveDirectoryMembershipProvider합니다.Not supported by ActiveDirectoryMembershipProvider.
LastLoginDate 해당 없음n/a 지원 되지 않습니다 ActiveDirectoryMembershipProvider합니다.Not supported by ActiveDirectoryMembershipProvider.
LastPasswordChangedDate pwdLastSet 아니요No
PasswordQuestion none, 있지만 암호 재설정 또는 검색을 위한 보안 질문 대답을 사용 하는 경우 특성에 매핑할 수 있습니다.none, but must be mapped to an attribute if using question-and-answer security for password reset or retrieval. 예, 하지만 유니코드 문자열 형식의 단일 값 특성 이어야 합니다.Yes, but must be a single-valued attribute of type Unicode String.
IsApproved User-Account-Control (AD)User-Account-Control (AD)

mDS-UserAccountDisabled (ADAM)mDS-UserAccountDisabled (ADAM)
아니요No
IsLockedOut 계산 lockoutTime 및 AD 잠금 기간 (Windows 2000 AD)computed from lockoutTime and the AD lockout duration (AD on Windows 2000)

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

msDS-User-Account-Control-Computed (ADAM)msDS-User-Account-Control-Computed (ADAM)
아니요No
LastLockoutDate 잘못 된 암호로 너무 많이 시도 하면 인해 잠겨 잠금 시간 특성이 반환 됩니다.If locked out due to too many bad password attempts, the lockout time attribute is returned.

잠기지 않는 너무 많은 잘못 된 암호 대답 시도 정의한 특성에 저장 된 값 attributeMapFailedPasswordAnswerLockoutTime 반환 됩니다.If locked out due to too many bad password answer attempts, the value stored in the attribute defined by attributeMapFailedPasswordAnswerLockoutTime is returned.

잠기지 않는 잘못 된 암호와 너무 많은 잘못 된 암호 시도 횟수, 가장 최근 날짜/시간 값이 반환 됩니다.If locked out due to both a bad password and too many bad password attempts, the most recent date/time value is returned.

계정이 잠겨 있지는 1/1/1753 SQL 호환성을 위한를 반환 합니다.If the account is not locked out, return 1/1/1753 for SQL compatibility.
아니요No

생성자

ActiveDirectoryMembershipUser()

ActiveDirectoryMembershipUser 클래스를 상속하는 클래스에 대한 ActiveDirectoryMembershipUser 개체의 새 인스턴스를 초기화합니다.Initializes a new instance of an ActiveDirectoryMembershipUser object for a class that inherits the ActiveDirectoryMembershipUser class.

ActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)

지정된 속성 값을 사용하여 ActiveDirectoryMembershipUser 클래스의 새 인스턴스를 만듭니다.Creates a new instance of the ActiveDirectoryMembershipUser class with the specified property values.

속성

Comment

멤버 자격 사용자에 대한 애플리케이션 관련 정보를 가져오거나 설정합니다.Gets or sets application-specific information for the membership user.

CreationDate

사용자가 멤버 자격 데이터 저장소에 추가된 날짜 및 시간을 가져옵니다.Gets the date and time when the user was added to the membership data store.

(다음에서 상속됨 MembershipUser)
Email

멤버 자격 사용자의 이메일 주소를 가져오거나 설정합니다.Gets or sets the email address of the membership user.

IsApproved

멤버 자격 사용자를 인증할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether the membership user can be authenticated.

IsLockedOut

멤버 자격 사용자가 잠겨서 유효성을 검사할 수 없는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the membership user is locked out and unable to be validated.

(다음에서 상속됨 MembershipUser)
IsOnline

사용자가 현재 온라인 상태인지 여부를 가져옵니다.Gets whether the user is currently online.

(다음에서 상속됨 MembershipUser)
LastActivityDate

모든 경우에 NotSupportedException 예외가 발생합니다.Throws a NotSupportedException exception in all cases.

LastLockoutDate

멤버 자격 사용자가 잠긴 가장 최근 날짜와 시간을 가져옵니다.Gets the most recent date and time that the membership user was locked out.

(다음에서 상속됨 MembershipUser)
LastLoginDate

모든 경우에 NotSupportedException 예외가 발생합니다.Throws a NotSupportedException exception in all cases.

LastPasswordChangedDate

멤버 자격 사용자의 암호를 마지막으로 업데이트한 날짜와 시간을 가져옵니다.Gets the date and time when the membership user's password was last updated.

(다음에서 상속됨 MembershipUser)
PasswordQuestion

멤버 자격 사용자에 대한 암호 질문을 가져옵니다.Gets the password question for the membership user.

(다음에서 상속됨 MembershipUser)
ProviderName

멤버 자격 사용자에 대한 사용자 정보를 저장하고 검색하는 멤버 자격 공급자의 이름을 가져옵니다.Gets the name of the membership provider that stores and retrieves user information for the membership user.

(다음에서 상속됨 MembershipUser)
ProviderUserKey

멤버 자격 사용자에 대한 Active Directory 데이터 저장소에서 사용자 ID를 가져옵니다.Gets the user identifier from the Active Directory data store for the membership user.

UserName

멤버 자격 사용자의 로그온 이름을 가져옵니다.Gets the logon name of the membership user.

(다음에서 상속됨 MembershipUser)

메서드

ChangePassword(String, String)

멤버 자격 데이터 저장소에서 멤버 자격 사용자 암호를 업데이트합니다.Updates the password for the membership user in the membership data store.

(다음에서 상속됨 MembershipUser)
ChangePasswordQuestionAndAnswer(String, String, String)

멤버 자격 데이터 저장소에서 멤버 자격 사용자의 암호 질문 및 답변을 업데이트합니다.Updates the password question and answer for the membership user in the membership data store.

(다음에서 상속됨 MembershipUser)
Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetPassword()

멤버 자격 데이터 저장소에서 멤버 자격 사용자 암호를 가져옵니다.Gets the password for the membership user from the membership data store.

(다음에서 상속됨 MembershipUser)
GetPassword(String)

멤버 자격 데이터 저장소에서 멤버 자격 사용자 암호를 가져옵니다.Gets the password for the membership user from the membership data store.

(다음에서 상속됨 MembershipUser)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
ResetPassword()

사용자 암호를 자동으로 생성된 새 암호로 다시 설정합니다.Resets a user's password to a new, automatically generated password.

(다음에서 상속됨 MembershipUser)
ResetPassword(String)

사용자 암호를 자동으로 생성된 새 암호로 다시 설정합니다.Resets a user's password to a new, automatically generated password.

(다음에서 상속됨 MembershipUser)
ToString()

멤버 자격 사용자의 사용자 이름을 반환합니다.Returns the user name for the membership user.

(다음에서 상속됨 MembershipUser)
UnlockUser()

멤버 자격 사용자의 유효성을 검사할 수 있도록 사용자의 잠금 상태를 해제합니다.Clears the locked-out state of the user so that the membership user can be validated.

(다음에서 상속됨 MembershipUser)

적용 대상

추가 정보