PrincipalCollection.Add Metoda

Definice

Obor názvů:

System.DirectoryServices.AccountManagement

Sestavení:

System.DirectoryServices.AccountManagement.dll

Balíček:

System.DirectoryServices.AccountManagement v8.0.0

Přidá zadaný objekt zabezpečení na konec kolekce.

Přetížení

Add(ComputerPrincipal)	Přidá zadaný ComputerPrincipal objekt na konec kolekce.
Add(GroupPrincipal)	Přidá zadaný GroupPrincipal objekt na konec kolekce.
Add(Principal)	Přidá zadaný Principal objekt na konec kolekce.
Add(UserPrincipal)	Přidá zadaný UserPrincipal objekt na konec kolekce.
Add(PrincipalContext, IdentityType, String)	Vyhledá Principal objekt, který odpovídá parametrům, a přidá ho na konec kolekce.

Poznámky

Stejně jako u Remove a Containsexistují čtyři přetížení této funkce, ale všechna fungují stejně. Dodatečná přetížení jsou implementována pouze za účelem zlepšení použitelnosti, takže vývojáři používající Technologii IntelliSense uvidí přetížení, která přebírají UserPrincipalobjekt , GroupPrincipalnebo ComputerPrincipal . Volání libovolného z přetížení Uživatel, Skupina nebo Počítač je přesně ekvivalentní volání Principal přetížení.

Add(ComputerPrincipal)

Zdroj:

PrincipalCollection.cs

Přidá zadaný ComputerPrincipal objekt na konec kolekce.

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)

Parametry

computer

ComputerPrincipal

Objekt ComputerPrincipal .

Poznámky

Tato funkce může vyvolat následující výjimky:

Výjimka	Description
PrincipalExistsException	computer již v kolekci existuje.

Add(GroupPrincipal)

Zdroj:

PrincipalCollection.cs

Přidá zadaný GroupPrincipal objekt na konec kolekce.

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)

Parametry

group

GroupPrincipal

Objekt ComputerPrincipal .

Poznámky

Tato funkce může vyvolat následující výjimky:

Výjimka	Description
PrincipalExistsException	group již v kolekci existuje.

Add(Principal)

Zdroj:

PrincipalCollection.cs

Přidá zadaný Principal objekt na konec kolekce.

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)

Parametry

principal

Principal

Objekt Principal .

Implementuje

Add(T)

Poznámky

Tato funkce může vyvolat následující výjimky:

Výjimka	Description
PrincipalExistsException	principal již v kolekci existuje.

Add(UserPrincipal)

Zdroj:

PrincipalCollection.cs

Přidá zadaný UserPrincipal objekt na konec kolekce.

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)

Parametry

user

UserPrincipal

Objekt UserPrincipal .

Poznámky

Tato funkce může vyvolat následující výjimky:

Výjimka	Description
PrincipalExistsException	user již v kolekci existuje.

Add(PrincipalContext, IdentityType, String)

Zdroj:

PrincipalCollection.cs

Vyhledá Principal objekt, který odpovídá parametrům, a přidá ho na konec kolekce.

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)

Parametry

context

PrincipalContext

Objekt PrincipalContext objektu zabezpečení, který se má přidat do kolekce.

identityType

IdentityType

ObjektIdentityType, který určuje formát .identityValue

identityValue

String

Řetězec, který identifikuje objekt zabezpečení ve formátu určeném parametrem identityType.

Poznámky

Tato funkce může vyvolat následující výjimky:

Výjimka	Description
PrincipalExistsException	Objekt zabezpečení odpovídající těmto parametrům již v kolekci existuje.
NoMatchingPrincipalException	Nebyl nalezen žádný objekt zabezpečení odpovídající zadaným parametrům.
MultipleMatchesException	Více než jeden objekt zabezpečení odpovídá zadaným parametrům.
ArgumentException	identityType je prázdný řetězec.