PersonalizationProvider.GetCountOfState Método

Definição

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

Quando sobrescrito numa classe derivada, devolve o número de linhas no armazenamento de dados subjacente que existem dentro do âmbito especificado.

public:
 abstract int GetCountOfState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query);
public abstract int GetCountOfState(System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query);
abstract member GetCountOfState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery -> int
Public MustOverride Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As Integer

Parâmetros

scope
PersonalizationScope

A PersonalizationScope da 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.

Devoluções

Int32

O número de linhas no armazenamento de dados subjacente que existem para o parâmetro especificado scope .

Observações

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

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 contados.

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

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

  • Se a UserInactiveSinceDate propriedade não for igual a MaxValue, então os registos contados 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 uma contagem 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 contagem devolvida seria zero.

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

Aplica-se a