Principal Principal Principal Principal Class

정의

모든 보안 주체에 공통되는 계정 데이터 및 작업을 캡슐화합니다.Encapsulates the account data and operations common to all security principals. 모든 보안 주체가 파생되는 추상 기본 클래스입니다.This is the abstract base class from which all security principals are derived.

public ref class Principal abstract : IDisposable
public abstract class Principal : IDisposable
type Principal = class
    interface IDisposable
Public MustInherit Class Principal
Implements IDisposable
상속
PrincipalPrincipalPrincipalPrincipal
파생
구현

설명

이 클래스에서 파생 된 사용자 지정 확장 프로그램 클래스는 기본 클래스를 초기화 하는 파생된 클래스 생성자에서이 생성자를 호출할 수 있습니다.Custom extension classes that derive from this class can call this constructor from the derived class constructor to initialize the base class. 자세한 내용은 참조는 보안 주체 확장 개요 항목입니다.For more information, see the Principal Extensions overview topic.

생성자

Principal() Principal() Principal() Principal()

Principal 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Principal class. 이 생성자는 파생 클래스 생성자에서 호출되어 기본 클래스를 초기화하며 코드에서 직접 호출할 수는 없습니다.This constructor is called by derived-class constructors to initialize the base class and is not intended to be called directly from your code.

속성

Context Context Context Context

보안 주체에 연결된 보안 주체 컨텍스트를 가져옵니다.Gets a principal context that is associated with the principal.

ContextRaw ContextRaw ContextRaw ContextRaw

이 보안 주체에 연결된 보안 주체 컨텍스트를 가져옵니다.Gets a principal context that is associated with this principal.

ContextType ContextType ContextType ContextType

이 보안 주체에 연결된 보안 주체 컨텍스트의 형식을 지정하는 컨텍스트 형식 열거형 값을 가져옵니다.Gets the context type enumeration value that specifies the type of principal context associated with this principal.

Description Description Description Description

보안 주체에 대한 설명을 가져오거나 설정합니다.Gets or sets the description of the principal.

DisplayName DisplayName DisplayName DisplayName

이 보안 주체의 표시 이름을 가져오거나 설정합니다.Gets or sets the display name for this principal.

DistinguishedName DistinguishedName DistinguishedName DistinguishedName

이 보안 주체의 DN(고유 이름)을 가져옵니다.Gets the distinguished name (DN) for this principal.

Guid Guid Guid Guid

이 보안 주체와 관련된 GUID를 가져옵니다.Gets the GUID associated with this principal.

Name Name Name Name

이 보안 주체의 이름을 가져오거나 설정합니다.Gets or sets the name of this principal.

SamAccountName SamAccountName SamAccountName SamAccountName

이 보안 주체의 SAM 계정 이름을 가져오거나 설정합니다.Gets or sets the SAM account name for this principal.

Sid Sid Sid Sid

보안 주체의 SID(보안 ID)를 가져옵니다.Gets the Security ID (SID) of the principal.

StructuralObjectClass StructuralObjectClass StructuralObjectClass StructuralObjectClass

구조적 개체 클래스 디렉터리 특성을 가져옵니다.Gets the structural object class directory attribute.

UserPrincipalName UserPrincipalName UserPrincipalName UserPrincipalName

이 보안 주체와 연결된 UPN(사용자 계정 이름)을 가져오거나 설정합니다.Gets or sets the user principal name (UPN) associated with this principal.

메서드

CheckDisposedOrDeleted() CheckDisposedOrDeleted() CheckDisposedOrDeleted() CheckDisposedOrDeleted()

이 클래스에서 Dispose() 또는 Delete() 메서드가 호출되었는지 여부를 확인합니다.Determines whether the Dispose() or Delete() methods have been called on this class. 이 메서드는 이 보안 주체 클래스에서 파생되는 클래스에서 호출합니다.This method is called by classes that derive from this principal class.

Delete() Delete() Delete() Delete()

저장소에서 보안 주체 개체를 삭제합니다.Deletes the principal object from the store.

Dispose() Dispose() Dispose() Dispose()

현재 인스턴스의 Principal 개체를 삭제합니다.Disposes the current instance of the Principal object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정된 개체가 현재 개체와 같은지 여부를 지정하는 부울 값을 반환합니다.Returns a Boolean value that specifies whether the supplied object is equal to the current object.

ExtensionGet(String) ExtensionGet(String) ExtensionGet(String) ExtensionGet(String)

확장된 클래스 개체의 특성을 검색합니다.Retrieves an attribute of an extended class object.

ExtensionSet(String, Object) ExtensionSet(String, Object) ExtensionSet(String, Object) ExtensionSet(String, Object)

확장 클래스에서 특성 값을 설정합니다.Sets the value of an attribute in an extended class.

FindByIdentity(PrincipalContext, IdentityType, String) FindByIdentity(PrincipalContext, IdentityType, String) FindByIdentity(PrincipalContext, IdentityType, String) FindByIdentity(PrincipalContext, IdentityType, String)

지정된 ID 형식 및 값과 일치하는 보안 주체 개체를 반환합니다.Returns a principal object that matches the specified identity type, and value. 이 버전의 FindByIdentity(PrincipalContext, IdentityType, String) 메서드는 ID 값의 형식을 결정합니다.This version of the FindByIdentity(PrincipalContext, IdentityType, String) method determines the format of the identity value.

FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String)

지정된 ID 값과 일치하는 보안 주체 개체를 반환합니다.Returns a principal object that matches the specified identity value.

FindByIdentityWithType(PrincipalContext, Type, IdentityType, String) FindByIdentityWithType(PrincipalContext, Type, IdentityType, String) FindByIdentityWithType(PrincipalContext, Type, IdentityType, String) FindByIdentityWithType(PrincipalContext, Type, IdentityType, String)

지정된 ID 형식 및 값과 일치하는 보안 주체 개체를 반환합니다.Returns a principal object that matches the specified identity type, and value. 이 메서드는 파생 클래스 FindByIdentity 메서드를 구현할 때 호출되어 파생 클래스 형식만 검색하도록 지정하며 코드에서 직접 호출할 수는 없습니다.This method is called by the implementation of the derived-class FindByIdentity method to restrict the search to the derived class type and is not intended to be called directly from your code.

FindByIdentityWithType(PrincipalContext, Type, String) FindByIdentityWithType(PrincipalContext, Type, String) FindByIdentityWithType(PrincipalContext, Type, String) FindByIdentityWithType(PrincipalContext, Type, String)

지정된 ID 형식 및 값과 일치하는 보안 주체 개체를 반환합니다.Returns a principal object that matches the specified identity type, and value. 이 메서드는 파생 클래스 FindByIdentity 메서드를 구현할 때 호출되어 파생 클래스 형식만 검색하도록 지정하며 코드에서 직접 호출할 수는 없습니다.This method is called by the implementation of the derived-class FindByIdentity method to restrict the search to the derived class type and is not intended to be called directly from your code.

GetGroups() GetGroups() GetGroups() GetGroups()

현재 보안 주체가 멤버인 그룹을 지정하는 그룹 개체의 컬렉션을 반환합니다.Returns a collection of group objects that specify the groups of which the current principal is a member.

GetGroups(PrincipalContext) GetGroups(PrincipalContext) GetGroups(PrincipalContext) GetGroups(PrincipalContext)

보안 주체가 멤버이고 지정된 컨텍스트 매개 변수에서 지정하는 저장소에 있는 그룹 개체의 컬렉션을 반환합니다.Returns a collection of group objects that the principal is a member of and that exist in the store provided by the specified context parameter.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

해시 테이블과 같은 데이터 구조 및 해시 알고리즘에서 사용하는 데 적합하며 보안 주체 개체의 내용을 사용하여 만든 해시를 검색합니다.Retrieves the hash created from the contents of the principal object, suited for use in hashing algorithms and data structures like a hash table.

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
GetUnderlyingObject() GetUnderlyingObject() GetUnderlyingObject() GetUnderlyingObject()

사용 개체의 연락처 데이터를 제공하는 기본 DirectoryEntry 개체를 반환합니다.Returns the underlying DirectoryEntry object that provides the contact data for the principal object.

GetUnderlyingObjectType() GetUnderlyingObjectType() GetUnderlyingObjectType() GetUnderlyingObjectType()

내부 개체 형식을 반환합니다.Returns the underlying object type.

IsMemberOf(GroupPrincipal) IsMemberOf(GroupPrincipal) IsMemberOf(GroupPrincipal) IsMemberOf(GroupPrincipal)

보안 주체가 지정된 그룹의 멤버인지 여부를 지정하는 부울 값을 반환합니다.Returns a Boolean value that specifies whether the principal is a member of the specified group.

IsMemberOf(PrincipalContext, IdentityType, String) IsMemberOf(PrincipalContext, IdentityType, String) IsMemberOf(PrincipalContext, IdentityType, String) IsMemberOf(PrincipalContext, IdentityType, String)

보안 주체가 ID 형식 및 값으로 지정된 그룹의 멤버인지 여부를 지정하는 부울 값을 반환합니다.Returns a Boolean value that specifies whether the principal is a member of the group specified by identity type and value.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
Save() Save() Save() Save()

보안 주체 개체에 대한 변경 내용을 저장소에 저장합니다.Saves the changes that were made on the principal object to the store. 새 보안 주체 개체인 경우에는 저장소에 삽입합니다.If this is a new principal object, this method inserts it into the store.

Save(PrincipalContext) Save(PrincipalContext) Save(PrincipalContext) Save(PrincipalContext)

보안 주체 개체에 대한 변경 내용을 저장소에 저장합니다.Saves the changes that were made on the principal object to the store. 새 보안 주체 개체인 경우에는 지정된 컨텍스트에 삽입합니다.If this is a new principal object, this method inserts it into the specified context. 보안 주체가 이미 유지되고 있는 경우에는 원래 컨텍스트에서 지정된 컨텍스트로 이동됩니다.If the principal has already been persisted, it is moved from the original context to the specified context.

ToString() ToString() ToString() ToString()

현재 보안 주체 개체에 대한 사용자에게 친숙한 문자열 표현을 반환합니다.Returns a user friendly string representation of the current principal object.

적용 대상