Partilhar via

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 existem 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

Uma 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 existe para o parâmetro especificado scope .

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 lida com caracteres como um asterisco (*), um símbolo percentual (%) 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 a qualquer momento 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 query for null ou todas as propriedades em query valores retornados null ou padrão, todos os registros correspondentes ao parâmetro indicado scope serão contados.

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

  • Se a UsernameToMatch propriedade não nullestiver, 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 somente 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:

Aplica-se a