SqlPersonalizationProvider.FindState Método

Definição

Espaço de Nomes:
System.Web.UI.WebControls.WebParts
Assemblagem:
System.Web.dll

Devolve uma coleção contendo zero ou mais PersonalizationStateInfoobjetos derivados, com base no âmbito e parâmetros especificados.

public:
 override 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 override 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);
override this.FindState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Overrides Function FindState (scope As PersonalizationScope, query As PersonalizationStateQuery, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parâmetros

scope
PersonalizationScope

A indica PersonalizationScope a informação de personalização a ser consultada. Este valor não pode ser null.

query
PersonalizationStateQuery

A PersonalizationStateQuery contendo uma consulta. Este valor pode ser null.

pageIndex
Int32

O local onde a consulta começa.

pageSize
Int32

O número de registos a devolver.

totalRecords
Int32

O número total de registos disponíveis.

Devoluções

PersonalizationStateInfoCollection

A contendo PersonalizationStateInfoCollection zero ou mais PersonalizationStateInfoobjetos derivados de .

Exceções

ArgumentException

pageIndex é inferior a zero.

-ou-

pageSize é menor ou igual a zero.

-ou-

A combinação de pageIndex e pageSize resulta num valor superior a Int32.MaxValue.

-ou-

PathToMatch é não-null e é um fio vazio ("") após aparar.

-ou-

O comprimento de PathToMatch é superior a 256 caracteres quando o valor é não-null.

-ou-

UsernameToMatch é não-null e é um fio vazio após aparação.

-ou-

O comprimento de UsernameToMatch é superior a 256 caracteres quando o valor é não-null.

ArgumentOutOfRangeException

O scope especificado não é um valor válido da PersonalizationScope enumeração.

Observações

O conjunto de itens devolvidos é limitado pelos pageSize parâmetros e, pageIndex onde pageSize controla o número de registos a devolver e pageIndex quais os registos a 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 obter todos os registos disponíveis, defina pageIndex para 0 e pageSize para MaxValue.

Os PersonalizationStateInfoobjetos derivados em são devolvidos por ordem alfabética, ordenados por Path e Username, 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 "~/approot", a PathToMatch propriedade seria definida como "~/approot%".

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 valor da PathToMatch propriedade.

  • 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:

Aplica-se a