Condividi tramite

SqlPersonalizationProvider.GetCountOfState Metodo

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Restituisce un conteggio del numero di righe nell'archivio dati sottostante esistente per il parametro specificato scope .

public:
 override int GetCountOfState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query);
public override int GetCountOfState(System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query);
override this.GetCountOfState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery -> int
Public Overrides Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As Integer

Parametri

scope
PersonalizationScope

Oggetto PersonalizationScope che indica le informazioni di personalizzazione su cui eseguire query. Questo valore non può essere null.

query
PersonalizationStateQuery

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

Restituisce

Int32

Numero di righe nell'archivio dati sottostante esistenti per il parametro specificato scope .

Eccezioni

ArgumentException

PathToMatch è diversonull da e è una stringa vuota ("") dopo il taglio.

oppure

La lunghezza di è maggiore di PathToMatch 256 caratteri quando il valore non ènull.

oppure

UsernameToMatch è diversonull da e è una stringa vuota dopo il taglio.

oppure

La lunghezza di è maggiore di UsernameToMatch 256 caratteri quando il valore non ènull.

ArgumentOutOfRangeException

L'oggetto scope specificato non è un valore valido dall'enumerazione PersonalizationScope .

Commenti

Questo metodo passa caratteri jolly di query all'archivio dati sottostante. Il supporto per i caratteri jolly dipende attualmente dal modo in cui ogni provider gestisce i caratteri, ad esempio 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 "~/approot", la PathToMatch proprietà verrà impostata su "~/approot%".

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 ed è querynull o tutte le proprietà sui query valori restituiti null o predefiniti, vengono restituiti tutti i record corrispondenti al parametro indicato scope .

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

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

  • Se la UserInactiveSinceDate proprietà non è uguale a MaxValue, vengono filtrati anche i record restituiti 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 associati agli utenti inattivi nell'ambito condiviso. Poiché non esiste alcun concetto di personalizzazioni inattive, il conteggio restituito sarebbe zero.

Le combinazioni di parametri che possono restituire una raccolta non vuota includono:

Si applica a