Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo PersonalizationAdministration.FindSharedState (String, Int32, Int32, Int32)

 

Data di pubblicazione: ottobre 2016

Restituisce una raccolta di informazioni sullo stato di personalizzazione condivisa in base ai parametri specificati.

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

public static PersonalizationStateInfoCollection FindSharedState(
	string pathToMatch,
	int pageIndex,
	int pageSize,
	out int totalRecords
)

Parametri

pathToMatch
Type: System.String

Il percorso della pagina per trovare la corrispondenza.

pageIndex
Type: System.Int32

Indice in base zero della pagina di risultati da restituire.

pageSize
Type: System.Int32

Il numero di record da restituire.

totalRecords
Type: System.Int32

Il numero totale di record disponibili.

Valore restituito

Type: System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Oggetto PersonalizationStateInfoCollection che contiene informazioni sullo stato di personalizzazione condivisa.

Exception Condition
ArgumentException

pathToMatch prima o dopo la rimozione è una stringa vuota ("").

-oppure-

pageIndex è minore di zero.

-oppure-

pageSize è minore o uguale a zero.

-oppure-

La combinazione di pageIndex e pageSize supera MaxValue.

-oppure-

Il provider per un provider di personalizzazione definito nella configurazione non è del tipo corretto.

-oppure-

La lunghezza della stringa di qualsiasi parametro è maggiore di 256 caratteri.

ConfigurationErrorsException

Si è verificata un'eccezione di configurazione durante il tentativo di creare e inizializzare un'istanza di uno dei provider di personalizzazioni.

-oppure-

Impossibile trovare il provider di personalizzazione predefinito definito nella configurazione.

Questo metodo restituisce una raccolta di UserPersonalizationStateInfo istanze in cui il pathToMatch valore corrisponde al percorso di una pagina di dati dello stato di personalizzazione condivisa. La raccolta contiene solo SharedPersonalizationStateInfo istanze.

Questo metodo passa caratteri jolly di parametro al provider di personalizzazioni sottostante, così come l'archivio dati gestisce questi caratteri dipende da come il provider gestisce i caratteri, ad esempio un asterisco (*), un simbolo di percentuale (%) o un carattere di sottolineatura (_).

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

Utilizzando il provider di personalizzazione predefinito, il PersonalizationStateInfo-oggetti derivati vengono restituiti in ordine alfabetico e ordinati in base a una combinazione di percorso e il nome utente in ordine crescente. L'ordine degli oggetti nella raccolta è determinato dal provider.

Il pathToMatch parametro può essere null. Se impostato su null, il parametro viene ignorato durante l'esecuzione di query.

I dati restituiti sono vincolati da pageIndex e pageSize, dove pageIndex Controlla i record da restituire e pageSize Controlla il numero di record da restituire. Ad esempio, se pageIndex è stata impostata su 0 e pageSize stato impostato su 25, i dati restituiti corrisponderanno alle prime 25 voci. Se pageIndex è stata impostata su 1 e pageSize è stato impostato su 25, i dati restituiti corrisponderanno alle voci da 26 a 50. Il totalRecords parametro restituisce il numero totale di record che sono disponibili.

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: