PersonalizationProvider.GetCountOfState(PersonalizationScope, PersonalizationStateQuery) Método

Definição

Quando substituído em uma classe derivada, retorna o número de linhas no armazenamento de dados subjacente que existe dentro do escopo especificado.When overridden in a derived class, returns the number of rows in the underlying data store that exist within the specified scope.

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.A PersonalizationScope of the personalization information to be queried. Esse valor não pode ser null.This value cannot be null.

query
PersonalizationStateQuery

Uma PersonalizationStateQuery que contém uma consulta.A PersonalizationStateQuery containing a query. Este valor pode ser null.This value can be null.

Retornos

Int32

O número de linhas no armazenamento de dados subjacente que existem para o parâmetro scope especificado.The number of rows in the underlying data store that exist for the specified scope parameter.

Comentários

Esse método é a definição abstrata de um método administrativo para recuperar contagens de dados de personalização.This method is the abstract definition of an administrative method for retrieving counts of personalization data. As implementações derivadas devem seguir a lógica descrita abaixo.Derived implementations should follow the logic described below.

Esse método passa caracteres curinga de consulta para o armazenamento de dados subjacente.This method passes query wildcard characters to the underlying data store. No momento, o suporte para caracteres curinga depende de como cada provedor manipula caracteres como um asterisco (*), um símbolo de porcentagem (%) ou um sublinhado ().Support for wildcard characters is currently dependent on how each provider handles characters such as an asterisk (*), a percent symbol (%), or an underscore ().

Normalmente, para armazenamentos de dados compatíveis com SQL, você pode executar uma pesquisa de curinga em um caminho parcial com o caractere curinga que aparece no início, no final ou no meio do texto da cadeia de caracteres de pesquisa na PathToMatch propriedade.Normally, for SQL-compliant data stores, you can perform a wildcard search on a partial path with the wildcard character appearing at the beginning, the end, or the middle of the search string text in the PathToMatch property. Por exemplo, para localizar todos os caminhos que começam com " ~ /vdir", a PathToMatch propriedade seria definida como " ~ /vdir%".For example, to find all paths that start with "~/vdir", the PathToMatch property would be set to "~/vdir%".

Da mesma forma, uma pesquisa curinga em um nome de usuário parcial poderia ter o caractere curinga exibido em qualquer ponto na cadeia de texto da UsernameToMatch propriedade.Likewise, a wildcard search on a partial user name could have the wildcard character appear at any point in the text string of the UsernameToMatch property. Por exemplo, para localizar todos os nomes de usuário que começam com "John", o UsernameToMatch parâmetro ficaria como "João%".For example, to find all user names that start with "John", the UsernameToMatch parameter would look like "John%".

As seguintes restrições de consulta se aplicam:The following query constraints apply:

  • Se scope for fornecido apenas, e query for null ou todas as propriedades em query retornarem null ou valores padrão, todos os registros correspondentes ao scope parâmetro indicado serão contados.If only scope is provided, and query is null or all the properties on query return either null or default values, then all records matching the indicated scope parameter are counted.

  • Se a PathToMatch propriedade não for null , os registros contados também serão filtrados com base nos caminhos que correspondem ao PathToMatch valor.If the PathToMatch property is not null, the counted records are also filtered based on paths that match the PathToMatch value.

  • Se a UsernameToMatch propriedade não for null , os registros contados também serão filtrados com base nos nomes de usuário que correspondem ao UsernameToMatch valor da propriedade.If the UsernameToMatch property is not null, the counted records are also filtered based on user names that match the UsernameToMatch property value.

  • 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.If the UserInactiveSinceDate property is not equal to MaxValue, then the counted records are also filtered to return only those records associated with inactive users. A comparação inclui registros em que a LastActivityDate propriedade é menor ou igual à UserInactiveSinceDate propriedade.The comparison includes records where the LastActivityDate property is less than or equal to the UserInactiveSinceDate property.

Observe que esse método não valida combinações de parâmetros de consulta.Note that this method does not validate combinations of query parameters. 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.For example, code can request a count of personalization state records associated with a specific user name in the shared scope. Como os nomes de usuário não estão associados a informações compartilhadas, a contagem retornada será zero.Because user names are not associated with shared information, the returned count would be zero.

As combinações de parâmetros que têm o potencial de retornar uma contagem diferente de zero incluem:Parameter combinations that have the potential to return a non-zero count include:

Aplica-se a