Freigeben über


PrincipalCollection.Add Methode

Definition

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

Parameter

computer
ComputerPrincipal

Ein ComputerPrincipal-Objekt.

Attribute

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Ausnahme Beschreibung
PrincipalExistsException computer ist bereits in der Auflistung vorhanden.

Gilt für:

Add(GroupPrincipal)

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

Parameter

group
GroupPrincipal

Ein ComputerPrincipal-Objekt.

Attribute

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Ausnahme Beschreibung
PrincipalExistsException group ist bereits in der Auflistung vorhanden.

Gilt für:

Add(Principal)

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

Parameter

principal
Principal

Ein Principal-Objekt.

Implementiert

Attribute

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Ausnahme Beschreibung
PrincipalExistsException principal ist bereits in der Auflistung vorhanden.

Gilt für:

Add(UserPrincipal)

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

Parameter

user
UserPrincipal

Ein UserPrincipal-Objekt.

Attribute

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Ausnahme Beschreibung
PrincipalExistsException user ist bereits in der Auflistung vorhanden.

Gilt für:

Add(PrincipalContext, IdentityType, String)

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

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.

Attribute

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.

Gilt für: