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 オブジェクトを検索し、コレクションの末尾に追加します。

注釈

と の場合とRemoveContains同様に、この関数には 4 つのオーバーロードがありますが、これらはすべて同じことを行います。 追加のオーバーロードは、使いやすさを向上させるためにのみ実装されるため、IntelliSense を使用する開発者は、GroupPrincipalまたは ComputerPrincipal オブジェクトを受け取るオーバーロードをUserPrincipal参照できます。 User、Group、または Computer のいずれかのオーバーロードを呼び出すことは、オーバーロードの呼び出し Principal とまったく同じです。

Add(ComputerPrincipal)

ソース:

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 オブジェクト。

注釈

この関数は、次の例外をスローできます。

例外	説明
PrincipalExistsException	computer はコレクションに既に存在します。

Add(GroupPrincipal)

ソース:

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 オブジェクト。

注釈

この関数は、次の例外をスローできます。

例外	説明
PrincipalExistsException	group はコレクションに既に存在します。

Add(Principal)

ソース:

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)

注釈

この関数は、次の例外をスローできます。

例外	説明
PrincipalExistsException	principal はコレクションに既に存在します。

Add(UserPrincipal)

ソース:

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 オブジェクト。

注釈

この関数は、次の例外をスローできます。

例外	説明
PrincipalExistsException	user はコレクションに既に存在します。

Add(PrincipalContext, IdentityType, String)

ソース:

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形式でプリンシパルを識別する文字列。

注釈

この関数は、次の例外をスローできます。

例外	説明
PrincipalExistsException	これらのパラメーターに一致するプリンシパルは、コレクションに既に存在します。
NoMatchingPrincipalException	指定したパラメーターに一致するプリンシパルが見つかりませんでした。
MultipleMatchesException	複数のプリンシパルが、指定したパラメーターと一致します。
ArgumentException	identityType が空の文字列です。