PersonalizationProvider.FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32) Metodo

Definizione

Quando viene sottoposto a override in una classe derivata, restituisce un insieme che contiene zero o più oggetti derivati da PersonalizationStateInfo in base all'ambito e a parametri di query specifici.When overridden in a derived class, returns a collection containing zero or more PersonalizationStateInfo-derived objects based on scope and specific query parameters.

public:
 abstract System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public abstract System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query, int pageIndex, int pageSize, out int totalRecords);
abstract member FindState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public MustOverride Function FindState (scope As PersonalizationScope, query As PersonalizationStateQuery, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parametri

scope
PersonalizationScope

Oggetto PersonalizationScope che include le informazioni sulla personalizzazione su cui eseguire la query.A PersonalizationScope with 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.

pageIndex
Int32

Posizione in cui inizia la query.The location where the query starts.

pageSize
Int32

Numero di record da restituire.The number of records to return.

totalRecords
Int32

Numero totale di record disponibili.The total number of records available.

Restituisce

Un oggetto PersonalizationStateInfoCollection contenente zero o più oggetti derivati da PersonalizationStateInfo.A PersonalizationStateInfoCollection containing zero or more PersonalizationStateInfo-derived objects.

Commenti

Questo metodo è la definizione astratta di un metodo amministrativo per l'esecuzione di query sui dati di personalizzazione.This method is the abstract definition of an administrative method for querying personalization data. Le implementazioni derivate devono seguire la logica descritta di seguito.Derived implementations should follow the logic described below.

Il set di elementi restituiti è pageIndex vincolato dai parametri e pageSize , dove pageSize imposta il numero di record da restituire e pageIndex imposta i record da restituire.The set of returned items is constrained by the pageIndex and pageSize parameters, where pageSize sets the number of records to return and pageIndex sets which records to return. Ad esempio, un pageIndex valore pari a 0 pageSize e a di 25 restituirà le prime 25 occorrenze, mentre pageIndex una di 1 e pageSize una di 25 restituiranno occorrenze 26-50.For example, a pageIndex of 0 and a pageSize of 25 would return the first 25 occurrences, while a pageIndex of 1 and a pageSize of 25 would return occurrences 26-50. Se si desidera recuperare tutti i record disponibili, impostare pageIndex su 0 e pageSize su MaxValue.If you want to retrieve all available records, set pageIndex to 0 and pageSize to MaxValue.

Gli PersonalizationStateInfooggetti derivati da vengono restituiti in ordine alfabetico e ordinati in base Path a Username una combinazione di valori di proprietà e in ordine crescente.The PersonalizationStateInfo-derived objects are returned in alphabetical order and sorted by a combination of their Path and Username property values, both in ascending order.

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 restituiti tutti i record scope 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 returned.

  • Se la PathToMatch proprietà non nullè, i record restituiti vengono filtrati anche in base ai percorsi che PathToMatch corrispondono al valore.If the PathToMatch property is not null, the returned records are also filtered based on paths that match the PathToMatch value.

  • Se la UsernameToMatch proprietà non nullè, i record restituiti vengono filtrati anche in base ai nomi utente che UsernameToMatch corrispondono al valore della proprietà.If the UsernameToMatch property is not null, the returned 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 restituiti per restituire solo i record associati agli utenti inattivi.If the UserInactiveSinceDate property is not equal to MaxValue, then the returned 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 set di record di stato di personalizzazione associati a un nome utente specifico nell'ambito condiviso.For example, code can request a set of personalization state records associated with a specific user name in the shared scope. Poiché i nomi utente non sono associati alle informazioni condivise, la raccolta restituita sarà vuota.Because user names are not associated with shared information, the returned collection would be empty.

Le combinazioni di parametri che hanno la possibilità di restituire una raccolta non vuota includono:Parameter combinations that have the potential to return a non-empty collection include:

Si applica a