PrincipalCollection.Add Metodo

Definizione

Spazio dei nomi:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacchetto:

System.DirectoryServices.AccountManagement v8.0.0

Aggiunge l'entità di protezione specificata alla fine dell'insieme.

Overload

Add(ComputerPrincipal)	Aggiunge l'oggetto ComputerPrincipal specificato alla fine dell'insieme.
Add(GroupPrincipal)	Aggiunge l'oggetto GroupPrincipal specificato alla fine dell'insieme.
Add(Principal)	Aggiunge l'oggetto Principal specificato alla fine dell'insieme.
Add(UserPrincipal)	Aggiunge l'oggetto UserPrincipal specificato alla fine dell'insieme.
Add(PrincipalContext, IdentityType, String)	Cerca un oggetto Principal che corrisponde ai parametri e lo aggiunge alla fine dell'insieme.

Commenti

Come con Remove e Contains, Ci sono quattro overload per questa funzione, ma tutti fanno la stessa cosa. Gli overload aggiuntivi vengono implementati solo per migliorare l'usabilità, in modo che gli sviluppatori che usano IntelliSense visualizzino gli overload che accettano un UserPrincipaloggetto , GroupPrincipalo ComputerPrincipal . La chiamata a uno degli overload utente, gruppo o computer equivale esattamente alla chiamata dell'overload Principal .

Add(ComputerPrincipal)

Origine:

PrincipalCollection.cs

Aggiunge l'oggetto ComputerPrincipal specificato alla fine dell'insieme.

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)

Parametri

computer

ComputerPrincipal

Un oggetto ComputerPrincipal.

Commenti

Questa funzione può generare le eccezioni seguenti:

Eccezione	Descrizione
PrincipalExistsException	computer esiste già nella raccolta.

Add(GroupPrincipal)

Origine:

PrincipalCollection.cs

Aggiunge l'oggetto GroupPrincipal specificato alla fine dell'insieme.

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)

Parametri

group

GroupPrincipal

Un oggetto ComputerPrincipal.

Commenti

Questa funzione può generare le eccezioni seguenti:

Eccezione	Descrizione
PrincipalExistsException	group esiste già nella raccolta.

Add(Principal)

Origine:

PrincipalCollection.cs

Aggiunge l'oggetto Principal specificato alla fine dell'insieme.

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)

Parametri

principal

Principal

Un oggetto Principal.

Implementazioni

Add(T)

Commenti

Questa funzione può generare le eccezioni seguenti:

Eccezione	Descrizione
PrincipalExistsException	principal esiste già nella raccolta.

Add(UserPrincipal)

Origine:

PrincipalCollection.cs

Aggiunge l'oggetto UserPrincipal specificato alla fine dell'insieme.

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)

Parametri

user

UserPrincipal

Un oggetto UserPrincipal.

Commenti

Questa funzione può generare le eccezioni seguenti:

Eccezione	Descrizione
PrincipalExistsException	user esiste già nella raccolta.

Add(PrincipalContext, IdentityType, String)

Origine:

PrincipalCollection.cs

Cerca un oggetto Principal che corrisponde ai parametri e lo aggiunge alla fine dell'insieme.

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)

Parametri

context

PrincipalContext

Oggetto PrincipalContext per l'entità da aggiungere all'insieme.

identityType

IdentityType

Oggetto IdentityType che specifica il formato di identityValue.

identityValue

String

Stringa che identifica l'entità, nel formato specificato da identityType.

Commenti

Questa funzione può generare le eccezioni seguenti:

Eccezione	Descrizione
PrincipalExistsException	L'entità corrispondente a questi parametri esiste già nella raccolta.
NoMatchingPrincipalException	Non è stata trovata alcuna entità corrispondente ai parametri specificati.
MultipleMatchesException	Più di un'entità corrisponde ai parametri specificati.
ArgumentException	identityType è una stringa vuota