ActiveDirectoryMembershipProvider.DeleteUser(String, Boolean) Método

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Remove informações de associação do usuário do armazenamento de dados do Active Directory.

public:
 override bool DeleteUser(System::String ^ username, bool deleteAllRelatedData);

public override bool DeleteUser (string username, bool deleteAllRelatedData);

override this.DeleteUser : string * bool -> bool

Public Overrides Function DeleteUser (username As String, deleteAllRelatedData As Boolean) As Boolean

Parâmetros

username

String

O nome do usuário a ser excluído.

deleteAllRelatedData

Boolean

Este parâmetro é ignorado pelo método DeleteUser(String, Boolean).

Retornos

Boolean

true se o usuário foi excluído, caso contrário, false se o usuário não foi localizado no armazenamento de dados.

Exceções

ArgumentException

username está vazio ou excede o comprimento máximo do nome de usuário (normalmente de 256 caracteres).

- ou -

username contém vírgulas.

- ou -

O nome de usuário é mapeado para o atributo userPrincipalName e o parâmetro userName contém barras invertidas.

ArgumentNullException

username é null.

COMException

Ocorreu um erro durante a tentativa de excluir o usuário.

InvalidOperationException

O método DeleteUser(String, Boolean) é chamado antes que a instância ActiveDirectoryMembershipProvider seja inicializada.

Comentários

O DeleteUser método remove imediatamente o usuário identificado pelo username parâmetro . Como o armazenamento de dados do Active Directory não armazena informações do usuário em áreas separadas do diretório, o deleteAllRelatedData parâmetro é ignorado, embora precise ser definido true como ou false ao chamar o DeleteUser método.

A ActiveDirectoryMembershipProvider classe localiza a instância de usuário a ser excluída executando uma pesquisa de nível único para o nome de usuário no contêiner de usuários determinado pela cadeia de conexão. Consulte o tópico de ActiveDirectoryMembershipProvider classe para obter mais informações sobre cadeias de conexão.

username deve ter 64 caracteres ou menos.

Importante

Você não pode excluir usuários, a menos que as credenciais usadas para se conectar ao servidor do Active Directory tenham direitos de Administrador de Domínio (não recomendado) ou o direito de acesso "excluir instâncias filho".

Confira também

• Introdução à associação ASP.NET