PrincipalCollection.Add 메서드

정의

네임스페이스:

System.DirectoryServices.AccountManagement

어셈블리:

System.DirectoryServices.AccountManagement.dll

패키지:

System.DirectoryServices.AccountManagement v8.0.0

지정된 보안 주체를 컬렉션 끝에 추가합니다.

오버로드

Add(ComputerPrincipal)	컬렉션의 끝에 지정된 ComputerPrincipal 개체를 추가합니다.
Add(GroupPrincipal)	컬렉션의 끝에 지정된 GroupPrincipal 개체를 추가합니다.
Add(Principal)	컬렉션의 끝에 지정된 Principal 개체를 추가합니다.
Add(UserPrincipal)	컬렉션의 끝에 지정된 UserPrincipal 개체를 추가합니다.
Add(PrincipalContext, IdentityType, String)	매개 변수와 일치하는 Principal 개체를 찾아 컬렉션 끝에 추가합니다.

설명

와 마찬가지로 Remove 고 Contains,이 함수에 4 개의 오버 로드가 있지만 모두 동일한 작업을 수행 합니다. 추가 오버로드는 유용성을 향상시키기 위해 구현되므로 IntelliSense를 사용하는 개발자는 , GroupPrincipal또는 ComputerPrincipal 개체를 사용하는 오버로드를 UserPrincipal볼 수 있습니다. 호출 하는 것은 사용자, 그룹 또는 컴퓨터 오버 로드 중 하나를 호출 합니다 Principal 오버 로드 합니다.

Add(ComputerPrincipal)

Source:

PrincipalCollection.cs

컬렉션의 끝에 지정된 ComputerPrincipal 개체를 추가합니다.

public:
 void Add(System::DirectoryServices::AccountManagement::ComputerPrincipal ^ computer);

public void Add (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);

member this.Add : System.DirectoryServices.AccountManagement.ComputerPrincipal -> unit

Public Sub Add (computer As ComputerPrincipal)

매개 변수

computer

ComputerPrincipal

ComputerPrincipal 개체입니다.

설명

이 함수는 다음과 같은 예외를 throw 할 수 있습니다.

예외	설명
PrincipalExistsException	computer가 이미 컬렉션에 있는 경우

Add(GroupPrincipal)

Source:

PrincipalCollection.cs

컬렉션의 끝에 지정된 GroupPrincipal 개체를 추가합니다.

public:
 void Add(System::DirectoryServices::AccountManagement::GroupPrincipal ^ group);

public void Add (System.DirectoryServices.AccountManagement.GroupPrincipal group);

member this.Add : System.DirectoryServices.AccountManagement.GroupPrincipal -> unit

Public Sub Add (group As GroupPrincipal)

매개 변수

group

GroupPrincipal

ComputerPrincipal 개체입니다.

설명

이 함수는 다음과 같은 예외를 throw 할 수 있습니다.

예외	설명
PrincipalExistsException	group가 이미 컬렉션에 있는 경우

Add(Principal)

Source:

PrincipalCollection.cs

컬렉션의 끝에 지정된 Principal 개체를 추가합니다.

public:
 virtual void Add(System::DirectoryServices::AccountManagement::Principal ^ principal);

public void Add (System.DirectoryServices.AccountManagement.Principal principal);

abstract member Add : System.DirectoryServices.AccountManagement.Principal -> unit
override this.Add : System.DirectoryServices.AccountManagement.Principal -> unit

Public Sub Add (principal As Principal)

매개 변수

principal

Principal

Principal 개체입니다.

구현

Add(T)

설명

이 함수는 다음과 같은 예외를 throw 할 수 있습니다.

예외	설명
PrincipalExistsException	principal가 이미 컬렉션에 있는 경우

Add(UserPrincipal)

Source:

PrincipalCollection.cs

컬렉션의 끝에 지정된 UserPrincipal 개체를 추가합니다.

public:
 void Add(System::DirectoryServices::AccountManagement::UserPrincipal ^ user);

public void Add (System.DirectoryServices.AccountManagement.UserPrincipal user);

member this.Add : System.DirectoryServices.AccountManagement.UserPrincipal -> unit

Public Sub Add (user As UserPrincipal)

매개 변수

user

UserPrincipal

UserPrincipal 개체입니다.

설명

이 함수는 다음과 같은 예외를 throw 할 수 있습니다.

예외	설명
PrincipalExistsException	user가 이미 컬렉션에 있는 경우

Add(PrincipalContext, IdentityType, String)

Source:

PrincipalCollection.cs

매개 변수와 일치하는 Principal 개체를 찾아 컬렉션 끝에 추가합니다.

public:
 void Add(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);

public void Add (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

member this.Add : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> unit

Public Sub Add (context As PrincipalContext, identityType As IdentityType, identityValue As String)

매개 변수

context

PrincipalContext

컬렉션에 추가할 보안 주체에 대한 PrincipalContext 개체입니다.

identityType

IdentityType

IdentityType 형식을 지정하는 개체입니다identityValue.

identityValue

String

에서 지정 identityType한 형식으로 보안 주체를 식별하는 문자열입니다.

설명

이 함수는 다음과 같은 예외를 throw 할 수 있습니다.

예외	설명
PrincipalExistsException	이러한 매개 변수를 이미 일치 하는 보안 주체가 컬렉션에 존재 합니다.
NoMatchingPrincipalException	지정된 된 매개 변수와 일치 하는 보안 주체가 없는 찾을 수 있습니다.
MultipleMatchesException	둘 이상의 보안 주체는 지정된 된 매개 변수를 찾습니다.
ArgumentException	identityType이 빈 문자열인 경우