ActiveDirectoryMembershipProvider.GetUser Método

  • Referência

Definição

Namespace:
System.Web.Security
Assembly:
System.Web.dll

Obtém as informações de um usuário associado no armazenamento de dados do Active Directory.

Sobrecargas

GetUser(String, Boolean)

Obtém as informações de usuário associado relacionadas ao nome de usuário especificado.
GetUser(Object, Boolean)

Obtém as informações de usuário associado relacionadas à chave de usuário especificada.

GetUser(String, Boolean)

Obtém as informações de usuário associado relacionadas ao nome de usuário especificado.

public:
 override System::Web::Security::MembershipUser ^ GetUser(System::String ^ username, bool userIsOnline);
public override System.Web.Security.MembershipUser GetUser (string username, bool userIsOnline);
override this.GetUser : string * bool -> System.Web.Security.MembershipUser
Public Overrides Function GetUser (username As String, userIsOnline As Boolean) As MembershipUser

Parâmetros

username
String

O nome do usuário para o qual obter informações.

userIsOnline
Boolean

O método GetUser(String, Boolean) ignora esse parâmetro.

Retornos

MembershipUser

Uma instância MembershipUser que representa o usuário especificado. Se nenhum usuário for encontrado no armazenamento de dados do Active Directory para o valor username especificado, null será retornado.

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.

InvalidOperationException

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

Comentários

O GetUser método é chamado pela Membership classe para recuperar informações sobre o usuário especificado do armazenamento de dados do Active Directory.

O provedor usa uma pesquisa de subárvores começando no ponto de pesquisa especificado na cadeia de conexão. Consulte o tópico de ActiveDirectoryMembershipProvider classe para obter mais informações sobre cadeias de conexão.

Os espaços à esquerda e à direita são cortados do valor de parâmetro username.

Confira também

Aplica-se a

GetUser(Object, Boolean)

Obtém as informações de usuário associado relacionadas à chave de usuário especificada.

public:
 override System::Web::Security::MembershipUser ^ GetUser(System::Object ^ providerUserKey, bool userIsOnline);
public override System.Web.Security.MembershipUser GetUser (object providerUserKey, bool userIsOnline);
override this.GetUser : obj * bool -> System.Web.Security.MembershipUser
Public Overrides Function GetUser (providerUserKey As Object, userIsOnline As Boolean) As MembershipUser

Parâmetros

providerUserKey
Object

O identificador exclusivo para o usuário.

userIsOnline
Boolean

O método GetUser(Object, Boolean) ignora esse parâmetro.

Retornos

MembershipUser

Uma instância MembershipUser que representa o usuário especificado. Se nenhum usuário for encontrado no armazenamento de dados do Active Directory para o valor providerUserKey especificado, null será retornado.

Exceções

InvalidOperationException

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

ArgumentException

providerUserKey não é do tipo SecurityIdentifier.

ArgumentNullException

providerUserKey é null.

Comentários

O GetUser método é chamado pela Membership classe para recuperar informações sobre o usuário especificado do armazenamento de dados do Active Directory.

A pesquisa procura uma instância de usuário em que o objectSID atributo corresponde ao providerUserKey parâmetro .

O provedor usa uma pesquisa de subárvores começando no ponto de pesquisa especificado na cadeia de conexão. Consulte o tópico de ActiveDirectoryMembershipProvider classe para obter mais informações sobre cadeias de conexão.

Aplica-se a