PrincipalCollection.Add Methode

Definition

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

Überlädt

Name Beschreibung
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 es am Ende der Auflistung hinzu.

Hinweise

Wie bei Remove und Contains, Es gibt vier Überladungen für diese Funktion, aber sie alle tun dasselbe. Die zusätzlichen Überladungen werden nur implementiert, um die Benutzerfreundlichkeit zu verbessern, sodass Entwickler, die IntelliSense verwenden, Überladungen sehen, die ein UserPrincipal, GroupPrincipaloder ComputerPrincipal ein Objekt verwenden. Das Aufrufen einer der Überladungen "Benutzer", "Gruppe" oder "Computer" entspricht genau dem Aufrufen der Principal Überladung.

Add(ComputerPrincipal)

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

Exception Description
PrincipalExistsException computer ist bereits in der Auflistung vorhanden.

Gilt für:

Add(GroupPrincipal)

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

Exception Description
PrincipalExistsException group ist bereits in der Auflistung vorhanden.

Gilt für:

Add(Principal)

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

Exception Description
PrincipalExistsException principal ist bereits in der Auflistung vorhanden.

Gilt für:

Add(UserPrincipal)

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

Exception Description
PrincipalExistsException user ist bereits in der Auflistung vorhanden.

Gilt für:

Add(PrincipalContext, IdentityType, String)

Quelle:
PrincipalCollection.cs
Quelle:
PrincipalCollection.cs
Quelle:
PrincipalCollection.cs
Quelle:
PrincipalCollection.cs

Sucht nach einem Principal Objekt, das den Parametern entspricht, und fügt es 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 identityValue.

identityValue
String

Eine Zeichenfolge, die den Prinzipal im durch .identityType

Attribute

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Exception Description
PrincipalExistsException Der Prinzipal, der diese Parameter abgleicht, 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: