PrincipalCollection.Add Método

Referência

Definição

Namespace:: System.DirectoryServices.AccountManagement

Assembly:: System.DirectoryServices.AccountManagement.dll

Pacote:: System.DirectoryServices.AccountManagement v6.0.0

Pacote:: System.DirectoryServices.AccountManagement v7.0.0

Pacote:: System.DirectoryServices.AccountManagement v8.0.0

Pacote:: System.DirectoryServices.AccountManagement v9.0.0-preview.2.24128.5

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Origem:: PrincipalCollection.cs

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);

[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)

Parâmetros

computer: ComputerPrincipal

Um objeto ComputerPrincipal.

Atributos: SecurityCriticalAttribute

Comentários

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

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

Aplica-se a

Add(GroupPrincipal)

Origem:: PrincipalCollection.cs

Origem:: PrincipalCollection.cs

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);

[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)

Parâmetros

group: GroupPrincipal

Um objeto ComputerPrincipal.

Atributos: SecurityCriticalAttribute

Comentários

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

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

Aplica-se a

Add(Principal)

Origem:: PrincipalCollection.cs

Origem:: PrincipalCollection.cs

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);

[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)

Parâmetros

principal: Principal

Um objeto Principal.

Implementações

Add(T)

Atributos: SecurityCriticalAttribute

Comentários

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

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

Aplica-se a

Add(UserPrincipal)

Origem:: PrincipalCollection.cs

Origem:: PrincipalCollection.cs

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);

[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)

Parâmetros

user: UserPrincipal

Um objeto UserPrincipal.

Atributos: SecurityCriticalAttribute

Comentários

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

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

Aplica-se a

Add(PrincipalContext, IdentityType, String)

Origem:: PrincipalCollection.cs

Origem:: PrincipalCollection.cs

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);

[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)

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.

Atributos: SecurityCriticalAttribute

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

Aplica-se a

Compartilhar via

PrincipalCollection.Add Método

Definição

Sobrecargas

Comentários

Add(ComputerPrincipal)

Parâmetros

Comentários

Aplica-se a

Add(GroupPrincipal)

Parâmetros

Comentários

Aplica-se a

Add(Principal)

Parâmetros

Implementações

Comentários

Aplica-se a

Add(UserPrincipal)

Parâmetros

Comentários

Aplica-se a

Add(PrincipalContext, IdentityType, String)

Parâmetros

Comentários

Aplica-se a

Recursos adicionais