PrincipalCollection.Add Método

Definição

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacote:

System.DirectoryServices.AccountManagement v8.0.0

Adiciona a entidade de segurança especificada ao final da coleção.

Sobrecargas

Add(ComputerPrincipal)	Adiciona o objeto ComputerPrincipal especificado ao final da coleção.
Add(GroupPrincipal)	Adiciona o objeto GroupPrincipal especificado ao final da coleção.
Add(Principal)	Adiciona o objeto Principal especificado ao final da coleção.
Add(UserPrincipal)	Adiciona o objeto UserPrincipal especificado ao final da coleção.
Add(PrincipalContext, IdentityType, String)	Pesquisa por um objeto Principal que corresponde aos parâmetros e o adiciona ao final da coleção.

Comentários

Assim como acontece com Remove e Contains, há quatro sobrecargas para essa função, mas todas elas fazem a mesma coisa. As sobrecargas extras são implementadas apenas para melhorar a usabilidade, para que os desenvolvedores que usam o IntelliSense vejam sobrecargas que usam um UserPrincipalobjeto , GroupPrincipalou ComputerPrincipal . Chamar qualquer uma das sobrecargas de Usuário, Grupo ou Computador é exatamente equivalente a chamar a Principal sobrecarga.

Add(ComputerPrincipal)

Origem:

PrincipalCollection.cs

Adiciona o objeto ComputerPrincipal especificado ao final da coleção.

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)

Parâmetros

computer

ComputerPrincipal

Um objeto ComputerPrincipal.

Comentários

Essa função pode gerar as seguintes exceções:

Exceção	Descrição
PrincipalExistsException	computer já existe na coleção.

Add(GroupPrincipal)

Origem:

PrincipalCollection.cs

Adiciona o objeto GroupPrincipal especificado ao final da coleção.

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)

Parâmetros

group

GroupPrincipal

Um objeto ComputerPrincipal.

Comentários

Essa função pode gerar as seguintes exceções:

Exceção	Descrição
PrincipalExistsException	group já existe na coleção.

Add(Principal)

Origem:

PrincipalCollection.cs

Adiciona o objeto Principal especificado ao final da coleção.

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)

Parâmetros

principal

Principal

Um objeto Principal.

Implementações

Add(T)

Comentários

Essa função pode gerar as seguintes exceções:

Exceção	Descrição
PrincipalExistsException	principal já existe na coleção.

Add(UserPrincipal)

Origem:

PrincipalCollection.cs

Adiciona o objeto UserPrincipal especificado ao final da coleção.

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)

Parâmetros

user

UserPrincipal

Um objeto UserPrincipal.

Comentários

Essa função pode gerar as seguintes exceções:

Exceção	Descrição
PrincipalExistsException	user já existe na coleção.

Add(PrincipalContext, IdentityType, String)

Origem:

PrincipalCollection.cs

Pesquisa por um objeto Principal que corresponde aos parâmetros e o adiciona ao final da coleção.

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)

Parâmetros

context

PrincipalContext

O objeto PrincipalContext da entidade de segurança a ser adicionada à coleção.

identityType

IdentityType

Um IdentityType objeto que especifica o formato de identityValue.

identityValue

String

Uma cadeia de caracteres que identifica a entidade de segurança, no formato especificado por identityType.

Comentários

Essa função pode gerar as seguintes exceções:

Exceção	Descrição
PrincipalExistsException	A entidade de segurança que corresponde a esses parâmetros já existe na coleção.
NoMatchingPrincipalException	Nenhuma entidade de segurança que corresponda aos parâmetros especificados foi encontrada.
MultipleMatchesException	Mais de uma entidade de segurança corresponde aos parâmetros especificados.
ArgumentException	identityType é uma cadeia de caracteres vazia