SqlPersonalizationProvider.GetCountOfState Metodo

  • Riferimento

Definizione

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

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

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

Eccezioni

ArgumentException

Il valore della proprietà PathToMatch è diverso da null e, dopo l'operazione di taglio, corrisponde a una stringa vuota ("").

-oppure-

La lunghezza della proprietà PathToMatch è maggiore di 256 caratteri quando il valore è diverso da null.

-oppure-

Il valore della proprietà UsernameToMatch è diverso da null e, dopo l'operazione di taglio, corrisponde a una stringa vuota.

-oppure-

La lunghezza della proprietà UsernameToMatch è maggiore di 256 caratteri quando il valore è diverso da null.

ArgumentOutOfRangeException

L'elemento scope specificato non è un valore valido dell'enumerazione PersonalizationScope.

Commenti

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 "~/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 e è 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, i record restituiti 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 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