PrincipalCollection.Add PrincipalCollection.Add PrincipalCollection.Add PrincipalCollection.Add Method

Definition

Fügt den angegebenen Prinzipal am Ende der Auflistung hinzu.Adds the specified principal to the end of the collection.

Überlädt

Add(ComputerPrincipal) Add(ComputerPrincipal) Add(ComputerPrincipal) Add(ComputerPrincipal)

Fügt das angegebene ComputerPrincipal-Objekt am Ende der Auflistung hinzu.Adds the specified ComputerPrincipal object to the end of the collection.

Add(GroupPrincipal) Add(GroupPrincipal) Add(GroupPrincipal) Add(GroupPrincipal)

Fügt das angegebene GroupPrincipal-Objekt am Ende der Auflistung hinzu.Adds the specified GroupPrincipal object to the end of the collection.

Add(Principal) Add(Principal) Add(Principal)

Fügt das angegebene Principal-Objekt am Ende der Auflistung hinzu.Adds the specified Principal object to the end of the collection.

Add(UserPrincipal) Add(UserPrincipal) Add(UserPrincipal) Add(UserPrincipal)

Fügt das angegebene UserPrincipal-Objekt am Ende der Auflistung hinzu.Adds the specified UserPrincipal object to the end of the collection.

Add(PrincipalContext, IdentityType, String) Add(PrincipalContext, IdentityType, String) Add(PrincipalContext, IdentityType, String)

Sucht nach einem Principal-Objekt, das den Parametern entspricht, und fügt dieses am Ende der Auflistung hinzu.Searches for a Principal object that matches the parameters, and adds it to the end of the collection.

Hinweise

Wie bei "Remove" und "Contains" sind vier über Ladungen für diese Funktion vorhanden, die jedoch alle identisch sind.As with Remove and Contains, There are four overloads to this function, but they all do the same thing. Die zusätzlichen über Ladungen werden nur zur Verbesserung der Benutzerfreundlichkeit implementiert, damit Entwickler, die IntelliSense verwenden, über Ladungen sehen können, die ein UserPrincipal-, GroupPrincipal-oder ComputerPrincipal-Objekt akzeptieren.The extra overloads are only implemented to improve usability, so that developers using IntelliSense see overloads that take a UserPrincipal, GroupPrincipal, or ComputerPrincipal object. Das Aufrufen einer der Benutzer-, Gruppen-oder Computer Überladungen entspricht exakt dem Aufrufen der Überladung "Principal".Calling any one of the User, Group, or Computer overloads is exactly equivalent to calling the Principal overload.

Add(ComputerPrincipal) Add(ComputerPrincipal) Add(ComputerPrincipal) Add(ComputerPrincipal)

Fügt das angegebene ComputerPrincipal-Objekt am Ende der Auflistung hinzu.Adds the specified ComputerPrincipal object to the end of the collection.

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
Public Sub Add (computer As ComputerPrincipal)

Parameter

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:This function can throw the following exceptions:

AusnahmeException BeschreibungDescription
PrincipalExistsException computer ist bereits in der Auflistung vorhanden.computer already exists in the collection.

Add(GroupPrincipal) Add(GroupPrincipal) Add(GroupPrincipal) Add(GroupPrincipal)

Fügt das angegebene GroupPrincipal-Objekt am Ende der Auflistung hinzu.Adds the specified GroupPrincipal object to the end of the collection.

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
Public Sub Add (group As GroupPrincipal)

Parameter

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:This function can throw the following exceptions:

AusnahmeException BeschreibungDescription
PrincipalExistsException group ist bereits in der Auflistung vorhanden.group already exists in the collection.

Add(Principal) Add(Principal) Add(Principal)

Fügt das angegebene Principal-Objekt am Ende der Auflistung hinzu.Adds the specified Principal object to the end of the collection.

public:
 virtual 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

Parameter

principal
Principal Principal Principal Principal

Ein Principal-Objekt.A Principal object.

Implementiert

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:This function can throw the following exceptions:

AusnahmeException BeschreibungDescription
PrincipalExistsException principal ist bereits in der Auflistung vorhanden.principal already exists in the collection.

Add(UserPrincipal) Add(UserPrincipal) Add(UserPrincipal) Add(UserPrincipal)

Fügt das angegebene UserPrincipal-Objekt am Ende der Auflistung hinzu.Adds the specified UserPrincipal object to the end of the collection.

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
Public Sub Add (user As UserPrincipal)

Parameter

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:This function can throw the following exceptions:

AusnahmeException BeschreibungDescription
PrincipalExistsException user ist bereits in der Auflistung vorhanden.user already exists in the collection.

Add(PrincipalContext, IdentityType, String) Add(PrincipalContext, IdentityType, String) Add(PrincipalContext, IdentityType, String)

Sucht nach einem Principal-Objekt, das den Parametern entspricht, und fügt dieses am Ende der Auflistung hinzu.Searches for a Principal object that matches the parameters, and adds it to the end of the collection.

public:
 void Add(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::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

Parameter

context
PrincipalContext PrincipalContext PrincipalContext PrincipalContext

Das PrincipalContext-Objekt für den Prinzipal, der der Auflistung hinzugefügt werden soll.The PrincipalContext object for the principal to be added to the collection.

identityType
IdentityType IdentityType IdentityType IdentityType

Ein IdentityType-Objekt, das das Format von identityValue angibt.An IdentityType object that specifies the format of identityValue

identityValue
String String String String

Eine Zeichenfolge, die den Prinzipal identifiziert, im von identityType angegebenen Format.A string that identifies the principal, in the format specified by identityType

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:This function can throw the following exceptions:

AusnahmeException BeschreibungDescription
PrincipalExistsException Der Prinzipal, der diesen Parametern entspricht, ist bereits in der Auflistung vorhandenThe principal matching these parameters already exists in the collection.
NoMatchingPrincipalException Es wurde kein Prinzipal gefunden, der den angegebenen Parametern entspricht.No principal matching the specified parameters was found.
MultipleMatchesException Mehrere Prinzipale stimmen mit den angegebenen Parametern überein.More than one principal matches the specified parameters.
ArgumentException identityType ist eine leere Zeichenfolge.identityType is an empty string

Gilt für: