PrincipalCollection.Add Methode

Definition

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Paket:

System.DirectoryServices.AccountManagement v8.0.0

Fügt den angegebenen Prinzipal am Ende der Auflistung hinzu.

Überlädt

Add(ComputerPrincipal)	Fügt das angegebene ComputerPrincipal-Objekt am Ende der Auflistung hinzu.
Add(GroupPrincipal)	Fügt das angegebene GroupPrincipal-Objekt am Ende der Auflistung hinzu.
Add(Principal)	Fügt das angegebene Principal-Objekt am Ende der Auflistung hinzu.
Add(UserPrincipal)	Fügt das angegebene UserPrincipal-Objekt am Ende der Auflistung hinzu.
Add(PrincipalContext, IdentityType, String)	Sucht nach einem Principal-Objekt, das den Parametern entspricht, und fügt dieses am Ende der Auflistung hinzu.

Hinweise

Wie bei Remove und Containsgibt es vier Überladungen für diese Funktion, aber sie führen alle dasselbe aus. Die zusätzlichen Überladungen werden nur implementiert, um die Benutzerfreundlichkeit zu verbessern, sodass Entwickler, die IntelliSense verwenden, Überladungen sehen, die ein -, GroupPrincipal- UserPrincipaloder ComputerPrincipal -Objekt annehmen. Das Aufrufen einer der Benutzer-, Gruppen- oder Computerüberladungen entspricht genau dem Aufrufen der Principal Überladung.

Add(ComputerPrincipal)

Quelle:

PrincipalCollection.cs

Fügt das angegebene ComputerPrincipal-Objekt am Ende der Auflistung hinzu.

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)

Parameter

computer

ComputerPrincipal

Ein ComputerPrincipal-Objekt.

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Ausnahme	Beschreibung
PrincipalExistsException	computer ist bereits in der Auflistung vorhanden.

Add(GroupPrincipal)

Quelle:

PrincipalCollection.cs

Fügt das angegebene GroupPrincipal-Objekt am Ende der Auflistung hinzu.

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)

Parameter

group

GroupPrincipal

Ein ComputerPrincipal-Objekt.

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Ausnahme	Beschreibung
PrincipalExistsException	group ist bereits in der Auflistung vorhanden.

Add(Principal)

Quelle:

PrincipalCollection.cs

Fügt das angegebene Principal-Objekt am Ende der Auflistung hinzu.

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)

Parameter

principal

Principal

Ein Principal-Objekt.

Implementiert

Add(T)

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Ausnahme	Beschreibung
PrincipalExistsException	principal ist bereits in der Auflistung vorhanden.

Add(UserPrincipal)

Quelle:

PrincipalCollection.cs

Fügt das angegebene UserPrincipal-Objekt am Ende der Auflistung hinzu.

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)

Parameter

user

UserPrincipal

Ein UserPrincipal-Objekt.

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Ausnahme	Beschreibung
PrincipalExistsException	user ist bereits in der Auflistung vorhanden.

Add(PrincipalContext, IdentityType, String)

Quelle:

PrincipalCollection.cs

Sucht nach einem Principal-Objekt, das den Parametern entspricht, und fügt dieses am Ende der Auflistung hinzu.

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)

Parameter

context

PrincipalContext

Das PrincipalContext-Objekt für den Prinzipal, der der Auflistung hinzugefügt werden soll.

identityType

IdentityType

Ein IdentityType -Objekt, das das Format von identityValueangibt.

identityValue

String

Eine Zeichenfolge, die den Prinzipal im von identityTypeangegebenen Format identifiziert.

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Ausnahme	Beschreibung
PrincipalExistsException	Der Prinzipal, der diesen Parametern entspricht, ist bereits in der Auflistung vorhanden.
NoMatchingPrincipalException	Es wurde kein Prinzipal gefunden, der den angegebenen Parametern entspricht.
MultipleMatchesException	Mehrere Prinzipale entsprechen den angegebenen Parametern.
ArgumentException	identityType ist eine leere Zeichenfolge.