PrincipalCollection.Add Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee voegt u de opgegeven principal toe aan het einde van de verzameling.
Overloads
| Name | Description |
|---|---|
| Add(ComputerPrincipal) |
Hiermee voegt u het opgegeven ComputerPrincipal object toe aan het einde van de verzameling. |
| Add(GroupPrincipal) |
Hiermee voegt u het opgegeven GroupPrincipal object toe aan het einde van de verzameling. |
| Add(Principal) |
Hiermee voegt u het opgegeven Principal object toe aan het einde van de verzameling. |
| Add(UserPrincipal) |
Hiermee voegt u het opgegeven UserPrincipal object toe aan het einde van de verzameling. |
| Add(PrincipalContext, IdentityType, String) |
Zoekt naar een Principal object dat overeenkomt met de parameters en voegt het toe aan het einde van de verzameling. |
Opmerkingen
Net als bij Remove en Contains, er zijn vier overbelastingen voor deze functie, maar ze doen allemaal hetzelfde. De extra overbelastingen worden alleen geïmplementeerd om de bruikbaarheid te verbeteren, zodat ontwikkelaars die IntelliSense gebruiken overbelastingen zien die een UserPrincipal, GroupPrincipalof ComputerPrincipal object aannemen. Het aanroepen van een van de gebruikers-, groeps- of computeroverbelastingen komt precies overeen met het aanroepen van de Principal overbelasting.
Add(ComputerPrincipal)
Hiermee voegt u het opgegeven ComputerPrincipal object toe aan het einde van de verzameling.
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)
Parameters
- computer
- ComputerPrincipal
Een ComputerPrincipal-object.
- Kenmerken
Opmerkingen
Deze functie kan de volgende uitzonderingen genereren:
| Exception | Beschrijving |
|---|---|
| PrincipalExistsException |
computer bestaat al in de verzameling. |
Van toepassing op
Add(GroupPrincipal)
Hiermee voegt u het opgegeven GroupPrincipal object toe aan het einde van de verzameling.
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)
Parameters
- group
- GroupPrincipal
Een ComputerPrincipal-object.
- Kenmerken
Opmerkingen
Deze functie kan de volgende uitzonderingen genereren:
| Exception | Beschrijving |
|---|---|
| PrincipalExistsException |
group bestaat al in de verzameling. |
Van toepassing op
Add(Principal)
Hiermee voegt u het opgegeven Principal object toe aan het einde van de verzameling.
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)
Parameters
Implementeringen
- Kenmerken
Opmerkingen
Deze functie kan de volgende uitzonderingen genereren:
| Exception | Beschrijving |
|---|---|
| PrincipalExistsException |
principal bestaat al in de verzameling. |
Van toepassing op
Add(UserPrincipal)
Hiermee voegt u het opgegeven UserPrincipal object toe aan het einde van de verzameling.
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)
Parameters
- user
- UserPrincipal
Een UserPrincipal-object.
- Kenmerken
Opmerkingen
Deze functie kan de volgende uitzonderingen genereren:
| Exception | Beschrijving |
|---|---|
| PrincipalExistsException |
user bestaat al in de verzameling. |
Van toepassing op
Add(PrincipalContext, IdentityType, String)
Zoekt naar een Principal object dat overeenkomt met de parameters en voegt het toe aan het einde van de verzameling.
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)
Parameters
- context
- PrincipalContext
Het PrincipalContext object voor de principal dat moet worden toegevoegd aan de verzameling.
- identityType
- IdentityType
Een IdentityType object dat de notatie van identityValue.
- identityValue
- String
Een tekenreeks die de principal identificeert, in de indeling die is opgegeven door identityType.
- Kenmerken
Opmerkingen
Deze functie kan de volgende uitzonderingen genereren:
| Exception | Beschrijving |
|---|---|
| PrincipalExistsException | De principal die overeenkomt met deze parameters bestaat al in de verzameling. |
| NoMatchingPrincipalException | Er is geen principal gevonden die overeenkomt met de opgegeven parameters. |
| MultipleMatchesException | Meer dan één principal komt overeen met de opgegeven parameters. |
| ArgumentException |
identityType is een lege tekenreeks |