ActiveDirectoryMembershipProvider.GetAllUsers(Int32, Int32, Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém uma coleção de todos os utilizadores armazenados numa fonte de dados do Active Directory.
public:
override System::Web::Security::MembershipUserCollection ^ GetAllUsers(int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);public override System.Web.Security.MembershipUserCollection GetAllUsers(int pageIndex, int pageSize, out int totalRecords);override this.GetAllUsers : int * int * int -> System.Web.Security.MembershipUserCollectionPublic Overrides Function GetAllUsers (pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollectionParâmetros
- pageIndex
- Int32
O índice da página de resultados para devolver.
pageIndex é baseado em zero.
- pageSize
- Int32
O tamanho da página de resultados para devolver.
- totalRecords
- Int32
Quando este método retorna, contém o número total de registos devolvidos na coleção. Este parâmetro é passado sem inicializar.
Devoluções
A MembershipUserCollection contendo pageSizeMembershipUser instâncias que começam na página especificada por pageIndex.
Exceções
O GetAllUsers(Int32, Int32, Int32) método é chamado antes da ActiveDirectoryMembershipProvider instância ser inicializada.
pageIndex é inferior a 0.
-ou
pageSize é inferior a 1.
-ou-
pageSize multiplicado por pageIndex, mais pageSize, menos 1 é maior que Int32.MaxValue.
A propriedade EnableSearchMethods é false.
Observações
Este método é chamado pela classe Membership para recuperar informações do utilizador do armazenamento de dados Active Directory especificado no ficheiro de configuração da aplicação ASP.NET.
Os resultados devolvidos pelo GetAllUsers método são limitados pelos pageIndex parâmetros e pageSize . O pageSize parâmetro especifica o número máximo de MembershipUser instâncias a devolver na MembershipUserCollection coleção. O pageIndex parâmetro especifica qual página de resultados devolver, onde 0 (zero) indica a primeira página.
O parâmetro totalRecords é um parâmetro out definido para o número total de utilizadores correspondentes encontrados no armazenamento de dados Active Directory. Por exemplo, se houver 13 utilizadores para o armazenamento de dados configurado, e o pageIndex valor for 1 com la pageSize igual a 5, os MembershipUserCollection devolvidos conterão do sexto ao décimo utilizador. O totalRecords parâmetro seria definido para 13.
Pode controlar se permite a pesquisa de utilizadores definindo a propriedade EnableSearchMethods no ficheiro de configuração da aplicação usando o atributo enableSearchMethods do elemento membership (ASP.NET Settings Schema). Definir a EnableSearchMethods propriedade para false faz com que o GetAllUsers método lance uma NotSupportedException exceção.
O fornecedor utiliza uma pesquisa em subárvore que começa no ponto de pesquisa especificado na cadeia de ligação. Consulte o ActiveDirectoryMembershipProvider tópico da aula para mais informações sobre cordas de ligação.
Recomendamos que não ative a pesquisa em sistemas de produção até confirmar que as consultas de pesquisa emitidas pela ActiveDirectoryMembershipProvider classe não afetam negativamente o desempenho do seu servidor de diretórios. Como a ActiveDirectoryMembershipProvider classe foi concebida para um ambiente Web sem estado, não consegue utilizar as otimizações de paginação expostas pelas APIs subjacentes System.DirectoryServices . Isto significa que as operações de paginação durante pesquisas em grandes diretórios são muito dispendiosas e devem ser evitadas. As operações de pesquisa são sempre emitidas contra o servidor de diretório configurado na cadeia de ligação, ou contra um servidor selecionado automaticamente no caso de uma cadeia de ligação apontar para um domínio. O fornecedor não utiliza um catálogo global para os seus métodos de pesquisa.
