Sdílet prostřednictvím


PrincipalCollection.Add Metoda

Definice

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
Zdroj:
PrincipalCollection.cs
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);
[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)

Parametry

Atributy

Poznámky

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

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

Platí pro

Add(GroupPrincipal)

Zdroj:
PrincipalCollection.cs
Zdroj:
PrincipalCollection.cs
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);
[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)

Parametry

Atributy

Poznámky

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

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

Platí pro

Add(Principal)

Zdroj:
PrincipalCollection.cs
Zdroj:
PrincipalCollection.cs
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);
[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)

Parametry

principal
Principal

Objekt Principal .

Implementuje

Atributy

Poznámky

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

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

Platí pro

Add(UserPrincipal)

Zdroj:
PrincipalCollection.cs
Zdroj:
PrincipalCollection.cs
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);
[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)

Parametry

Atributy

Poznámky

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

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

Platí pro

Add(PrincipalContext, IdentityType, String)

Zdroj:
PrincipalCollection.cs
Zdroj:
PrincipalCollection.cs
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);
[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)

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.

Atributy

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.

Platí pro