PersonalizationProvider.GetCountOfState(PersonalizationScope, PersonalizationStateQuery) Metodo

Definizione

Quando viene sottoposto a override in una classe derivata, restituisce il numero di righe dell'archivio dati sottostante esistenti nell'ambito specificato.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

Parametri

scope
PersonalizationScope

Oggetto PersonalizationScope relativo alle informazioni sulla personalizzazione su cui eseguire la query.A PersonalizationScope of the personalization information to be queried. Questo valore non può essere null.This value cannot be null.

query
PersonalizationStateQuery

Oggetto PersonalizationStateQuery contenente una query.A PersonalizationStateQuery containing a query. Il valore può essere null.This value can be null.

Restituisce

Il numero di righe disponibili nell'archivio dati sottostante per il parametro scope specificato.The number of rows in the underlying data store that exist for the specified scope parameter.

Commenti

Questo metodo è la definizione astratta di un metodo amministrativo per il recupero dei conteggi dei dati sulla personalizzazione.This method is the abstract definition of an administrative method for retrieving counts of personalization data. Le implementazioni derivate devono seguire la logica descritta di seguito.Derived implementations should follow the logic described below.

Questo metodo passa i caratteri jolly della query all'archivio dati sottostante.This method passes query wildcard characters to the underlying data store. Il supporto per i caratteri jolly è attualmente dipendente dal modo in cui ogni provider gestisce i caratteri, ad esempio un asterisco (*), un simbolo di percentuale (%) o un carattere di sottolineatura ().Support for wildcard characters is currently dependent on how each provider handles characters such as an asterisk (*), a percent symbol (%), or an underscore ().

In genere, per gli archivi dati conformi a SQL, è possibile eseguire una ricerca con caratteri jolly in un percorso parziale con il carattere jolly visualizzato all'inizio, alla fine o al centro del testo della stringa di PathToMatch ricerca nella proprietà.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. Ad esempio, per trovare tutti i percorsi che iniziano con~"/vdir", PathToMatch la proprietà viene impostata su "~/vdir%".For example, to find all paths that start with "~/vdir", the PathToMatch property would be set to "~/vdir%".

Analogamente, una ricerca con caratteri jolly in un nome utente parziale può contenere il carattere jolly in qualsiasi punto della stringa di testo UsernameToMatch della proprietà.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. Ad esempio, per trovare tutti i nomi utente che iniziano con "John", UsernameToMatch il parametro sarà simile a "John%".For example, to find all user names that start with "John", the UsernameToMatch parameter would look like "John%".

Si applicano i seguenti vincoli di query:The following query constraints apply:

  • Se viene scope fornito solo, e query è null o tutte le proprietà in query restituiscono null o i valori predefiniti, vengono conteggiati tutti i scope record corrispondenti al parametro indicato.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 la PathToMatch proprietà non nullè, i record conteggiati vengono filtrati anche in base ai percorsi PathToMatch che corrispondono al valore.If the PathToMatch property is not null, the counted records are also filtered based on paths that match the PathToMatch value.

  • Se la UsernameToMatch proprietà non nullè, i record conteggiati vengono filtrati anche in base ai nomi utente UsernameToMatch che corrispondono al valore della proprietà.If the UsernameToMatch property is not null, the counted records are also filtered based on user names that match the UsernameToMatch property value.

  • Se la UserInactiveSinceDate proprietà non è uguale a MaxValue, vengono filtrati anche i record conteggiati per restituire solo i record associati agli utenti inattivi.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. Il confronto include i record LastActivityDate UserInactiveSinceDate in cui la proprietà è minore o uguale alla proprietà.The comparison includes records where the LastActivityDate property is less than or equal to the UserInactiveSinceDate property.

Si noti che questo metodo non convalida le combinazioni di parametri di query.Note that this method does not validate combinations of query parameters. Ad esempio, il codice può richiedere un conteggio dei record di stato di personalizzazione associati a un nome utente specifico nell'ambito condiviso.For example, code can request a count of personalization state records associated with a specific user name in the shared scope. Poiché i nomi utente non sono associati alle informazioni condivise, il conteggio restituito sarà zero.Because user names are not associated with shared information, the returned count would be zero.

Le combinazioni di parametri che possono restituire un numero diverso da zero includono:Parameter combinations that have the potential to return a non-zero count include:

Si applica a