Compartilhar via


PrincipalCollection.Add Método

Definição

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

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

Atributos

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

Atributos

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

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

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