SqlPersonalizationProvider.GetCountOfState Método

Definição

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

Devolve uma contagem do número de linhas no armazenamento de dados subjacente que existem para o parâmetro especificado scope .

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

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.

Devoluções

Int32

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

Exceções

ArgumentException

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

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 o UsernameToMatch não nullfor , os registos devolvidos 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 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 uma contagem dos registos de estado associados a utilizadores inativos no âmbito partilhado. Como não existe o conceito de personalizações inativas, a contagem devolvida seria zero.

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

Aplica-se a