PersonalizationProvider.GetCountOfState Metodo

Definizione

Spazio dei nomi:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Quando viene sottoposto a override in una classe derivata, restituisce il numero di righe dell'archivio dati sottostante esistenti nell'ambito specificato.

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. Questo valore non può essere null.

query

PersonalizationStateQuery

Oggetto PersonalizationStateQuery contenente una query. Il valore può essere null.

Restituisce

Int32

Il numero di righe disponibili nell'archivio dati sottostante per il parametro scope specificato.

Commenti

Questo metodo è la definizione astratta di un metodo amministrativo per recuperare i conteggi dei dati di personalizzazione. Le implementazioni derivate devono seguire la logica descritta di seguito.

Questo metodo passa i caratteri jolly della query all'archivio dati sottostante. Il supporto per i caratteri jolly dipende attualmente dal modo in cui ogni provider gestisce caratteri come un asterisco (*), un simbolo di percentuale (%) o un carattere di sottolineatura (_).

In genere, per gli archivi dati conformi a SQL, è possibile eseguire una ricerca con caratteri jolly su un percorso parziale con il carattere jolly visualizzato all'inizio, alla fine o al centro del testo della stringa di ricerca nella PathToMatch proprietà . Ad esempio, per trovare tutti i percorsi che iniziano con "~/vdir", la PathToMatch proprietà verrà impostata su "~/vdir%".

Analogamente, una ricerca con caratteri jolly su un nome utente parziale potrebbe includere il carattere jolly in qualsiasi punto nella stringa di testo della UsernameToMatch proprietà. Ad esempio, per trovare tutti i nomi utente che iniziano con "John", il UsernameToMatch parametro sarà simile a "John%".

Si applicano i vincoli di query seguenti:

• Se viene specificato solo scope e è querynull o tutte le proprietà per query i valori restituiti null o predefiniti, vengono conteggiati tutti i record corrispondenti al parametro indicato scope .

• Se la PathToMatch proprietà non nullè , anche i record con conteggiati vengono filtrati in base ai percorsi che corrispondono al PathToMatch valore.

• Se la UsernameToMatch proprietà non nullè , anche i record con conteggiati vengono filtrati in base ai nomi utente che corrispondono al valore della UsernameToMatch proprietà.

• Se la UserInactiveSinceDate proprietà non è uguale a MaxValue, i record con conteggiati vengono filtrati anche per restituire solo i record associati agli utenti inattivi. Il confronto include record in cui la LastActivityDate proprietà è minore o uguale alla UserInactiveSinceDate proprietà .

Si noti che questo metodo non convalida le combinazioni di parametri di query. Ad esempio, il codice può richiedere un conteggio dei record di stato di personalizzazione associati a un nome utente specifico nell'ambito condiviso. Poiché i nomi utente non sono associati a informazioni condivise, il conteggio restituito sarà zero.

Le combinazioni di parametri che possono restituire un conteggio diverso da zero includono:

• Shared ambito in combinazione con la PathToMatch proprietà .

• User ambito in combinazione con i valori per qualsiasi o tutte le PathToMatchproprietà , UsernameToMatche UserInactiveSinceDate .