PersonalizationProvider.GetCountOfState Método

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Quando substituído em uma classe derivada, retorna o número de linhas no armazenamento de dados subjacente que existe dentro do escopo 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

Um PersonalizationScope das informações de personalização a serem consultadas. Esse valor não pode ser null.

query

PersonalizationStateQuery

Uma PersonalizationStateQuery que contém uma consulta. Este valor pode ser null.

Retornos

Int32

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

Comentários

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

Esse método passa caracteres curinga de consulta para o armazenamento de dados subjacente. Atualmente, o suporte para caracteres curinga depende de como cada provedor manipula caracteres como um asterisco (*), um símbolo de porcentagem (%) ou um sublinhado (_).

Normalmente, para armazenamentos de dados em conformidade com SQL, você pode executar uma pesquisa curinga em um caminho parcial com o caractere curinga aparecendo no início, no final ou no meio do texto da cadeia de caracteres de pesquisa na PathToMatch propriedade . Por exemplo, para localizar todos os caminhos que começam com "~/vdir", a PathToMatch propriedade seria definida como "~/vdir%".

Da mesma forma, uma pesquisa curinga em um nome de usuário parcial pode fazer com que o caractere curinga apareça em qualquer ponto na cadeia de caracteres de texto da UsernameToMatch propriedade. Por exemplo, para localizar todos os nomes de usuário que começam com "John", o UsernameToMatch parâmetro se pareceria com "John%".

As seguintes restrições de consulta se aplicam:

• Se apenas scope for fornecido e for querynull ou todas as propriedades em query valores padrão ou retornados null , todos os registros correspondentes ao parâmetro indicado scope serão contados.

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

• Se a UsernameToMatch propriedade não nullfor , os registros contados também serão filtrados com base nos nomes de usuário que correspondem ao valor da UsernameToMatch propriedade.

• Se a UserInactiveSinceDate propriedade não for igual a MaxValue, os registros contados também serão filtrados para retornar apenas os registros associados a usuários inativos. A comparação inclui registros em que a LastActivityDate propriedade é menor ou igual à UserInactiveSinceDate propriedade .

Observe que esse método não valida combinações de parâmetros de consulta. Por exemplo, o código pode solicitar uma contagem de registros de estado de personalização associados a um nome de usuário específico no escopo compartilhado. Como os nomes de usuário não estão associados a informações compartilhadas, a contagem retornada seria zero.

As combinações de parâmetros que têm o potencial de retornar uma contagem diferente de zero incluem:

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

• User escopo em combinação com os valores para qualquer uma ou todas as PathToMatchpropriedades , UsernameToMatche UserInactiveSinceDate .