다음을 통해 공유


PrincipalCollection.Add 메서드

정의

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

오버로드

Add(ComputerPrincipal)

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

Add(GroupPrincipal)

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

Add(Principal)

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

Add(UserPrincipal)

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

Add(PrincipalContext, IdentityType, String)

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

설명

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

Add(ComputerPrincipal)

Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs

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

public:
 void Add(System::DirectoryServices::AccountManagement::ComputerPrincipal ^ computer);
public void Add (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);
member this.Add : System.DirectoryServices.AccountManagement.ComputerPrincipal -> unit
[<System.Security.SecurityCritical>]
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
Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs

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

public:
 void Add(System::DirectoryServices::AccountManagement::GroupPrincipal ^ group);
public void Add (System.DirectoryServices.AccountManagement.GroupPrincipal group);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.GroupPrincipal group);
member this.Add : System.DirectoryServices.AccountManagement.GroupPrincipal -> unit
[<System.Security.SecurityCritical>]
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
Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs

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

public:
 virtual void Add(System::DirectoryServices::AccountManagement::Principal ^ principal);
public void Add (System.DirectoryServices.AccountManagement.Principal principal);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.Principal principal);
abstract member Add : System.DirectoryServices.AccountManagement.Principal -> unit
override this.Add : System.DirectoryServices.AccountManagement.Principal -> unit
[<System.Security.SecurityCritical>]
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 개체입니다.

구현

특성

설명

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

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

적용 대상

Add(UserPrincipal)

Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs

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

public:
 void Add(System::DirectoryServices::AccountManagement::UserPrincipal ^ user);
public void Add (System.DirectoryServices.AccountManagement.UserPrincipal user);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.UserPrincipal user);
member this.Add : System.DirectoryServices.AccountManagement.UserPrincipal -> unit
[<System.Security.SecurityCritical>]
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
Source:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
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
[<System.Security.SecurityCritical>]
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이 빈 문자열인 경우

적용 대상