PersonalizationProvider.FindState Método

public:
 abstract System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public abstract System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindState(System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query, int pageIndex, int pageSize, out int totalRecords);

abstract member FindState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public MustOverride Function FindState (scope As PersonalizationScope, query As PersonalizationStateQuery, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parâmetros

Devoluções

A contendo PersonalizationStateInfoCollection zero ou mais PersonalizationStateInfoobjetos derivados de .

Observações

Este método é a definição abstrata de um método administrativo para consultar dados de personalização. As implementações derivadas devem seguir a lógica descrita abaixo.

O conjunto de itens devolvidos é limitado pelos pageIndex parâmetros e, pageSize onde pageSize define o número de registos a devolver e pageIndex define quais registos devolver. Por exemplo, a pageIndex de 0 e a pageSize de 25 devolveriam as primeiras 25 ocorrências, enquanto a pageIndex de 1 e a pageSize de 25 devolveriam ocorrências de 26 a 50. Se quiser recuperar todos os registos disponíveis, defina pageIndex para 0 e pageSize para MaxValue.

Os PersonalizationStateInfoobjetos derivados em são devolvidos por ordem alfabética e ordenados por uma combinação dos seus Path valores de propriedade e Username de proprietários, ambos por ordem crescente.

Este método passa os caracteres curinga de consulta para o armazenamento de dados subjacente. O suporte a caracteres coringa depende atualmente de como cada fornecedor lida com caracteres, como um asterisco (*), um símbolo percentual (%) ou um sublinhado (_).

Normalmente, para armazenamentos de dados compatíveis com SQL, pode realizar uma pesquisa coringa num caminho parcial, com o carácter curinga a aparecer no início, no fim ou no meio do texto da cadeia de pesquisa na PathToMatch propriedade. Por exemplo, para encontrar todos os caminhos que começam com "~/vdir", a PathToMatch propriedade seria definida como "~/vdir%".

Da mesma forma, uma pesquisa coringa num nome de utilizador parcial pode fazer com que o carácter curinga apareça em qualquer ponto da cadeia de texto da UsernameToMatch propriedade. Por exemplo, para encontrar todos os nomes de utilizador que começam por "John", o UsernameToMatch parâmetro seria "John%".

Aplicam-se as seguintes restrições de consulta:

• Se apenas scope for fornecido, e query for null ou todas as propriedades no query retorno ou null valores por defeito, então todos os registos que correspondem ao parâmetro indicado scope são devolvidos.

• Se a PathToMatch propriedade não nullfor , os registos devolvidos também são filtrados com base em caminhos que correspondem ao PathToMatch valor.

• Se a UsernameToMatch propriedade não nullfor , os registos devolvidos também são filtrados com base nos nomes de utilizador que correspondem ao valor da UsernameToMatch propriedade.

• Se a UserInactiveSinceDate propriedade não for igual a MaxValue, então os registos devolvidos também são filtrados para devolver apenas os registos associados a utilizadores inativos. A comparação inclui registos em que a LastActivityDate propriedade é inferior ou igual à UserInactiveSinceDate propriedade.

Note que este método não valida combinações de parâmetros de consulta. Por exemplo, o código pode solicitar um conjunto de registos de estado de personalização associados a um nome de utilizador específico no âmbito partilhado. Como os nomes de utilizador não estão associados à informação partilhada, a coleção devolvida ficaria vazia.

Combinações de parâmetros que têm potencial para devolver uma coleção não vazia incluem:

• Shared âmbito em combinação com a PathToMatch propriedade.

• User âmbito em combinação com os valores para qualquer ou todos os PathToMatch, UsernameToMatch, e UserInactiveSinceDate propriedades.