PersonalizationAdministration.FindSharedState Metodo

  • Riferimento

Definizione

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

Restituisce un insieme di informazioni condivise sullo stato di personalizzazione in base ai parametri specificati.

Overload

FindSharedState(String)

Restituisce un insieme di informazioni condivise sullo stato di personalizzazione in base al percorso specificato.
FindSharedState(String, Int32, Int32, Int32)

Restituisce un insieme di informazioni condivise sullo stato di personalizzazione in base ai parametri specificati.

FindSharedState(String)

Restituisce un insieme di informazioni condivise sullo stato di personalizzazione in base al percorso specificato.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindSharedState(System::String ^ pathToMatch);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindSharedState (string pathToMatch);
static member FindSharedState : string -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindSharedState (pathToMatch As String) As PersonalizationStateInfoCollection

Parametri

pathToMatch
String

Percorso della pagina da mettere in corrispondenza.

Restituisce

PersonalizationStateInfoCollection

Un oggetto PersonalizationStateInfoCollection che contiene informazioni condivise sullo stato di personalizzazione.

Eccezioni

ArgumentException

pathToMatch è una stringa vuota ("") prima o dopo l'operazione di taglio.

-oppure-

Il tipo di un provider di personalizzazioni definito nella configurazione non è corretto.

-oppure-

La lunghezza della stringa di un 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 configurati.

-oppure-

Non è stato possibile trovare il provider di personalizzazioni predefinito nella configurazione.

Commenti

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

Questo metodo passa i caratteri jolly dei parametri al provider di personalizzazione sottostante, quindi il modo in cui l'archivio dati gestisce questi caratteri dipende dal modo in cui il provider gestisce i caratteri, ad esempio un asterisco (*), un simbolo 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%".

Usando il provider di personalizzazione predefinito, gli PersonalizationStateInfooggetti derivati vengono restituiti in ordine alfabetico e ordinati in base a una combinazione di percorso e nome utente in ordine crescente. L'ordinamento degli oggetti nell'insieme è determinato dal provider.

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

Vedi anche

Si applica a

FindSharedState(String, Int32, Int32, Int32)

Restituisce un insieme di informazioni condivise sullo stato di personalizzazione in base ai parametri specificati.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindSharedState(System::String ^ pathToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindSharedState (string pathToMatch, int pageIndex, int pageSize, out int totalRecords);
static member FindSharedState : string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindSharedState (pathToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parametri

pathToMatch
String

Percorso della pagina da mettere in corrispondenza.

pageIndex
Int32

Indice in base zero della pagina di risultati da restituire.

pageSize
Int32

Numero di record da restituire.

totalRecords
Int32

Numero totale di record disponibili.

Restituisce

PersonalizationStateInfoCollection

Un oggetto PersonalizationStateInfoCollection che contiene informazioni condivise sullo stato di personalizzazione.

Eccezioni

ArgumentException

pathToMatch prima o dopo l'operazione di taglio, è una stringa vuota ("").

-oppure-

pageIndex è minore di zero.

-oppure-

pageSize è minore o uguale a zero.

-oppure-

La combinazione di pageIndex e pageSize supera Int32.MaxValue.

-oppure-

Il tipo di un provider di personalizzazioni definito nella configurazione non è corretto.

-oppure-

La lunghezza della stringa di un 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 configurati.

-oppure-

Non è stato possibile trovare il provider di personalizzazioni predefinito nella configurazione.

Commenti

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

Questo metodo passa i caratteri jolly dei parametri al provider di personalizzazione sottostante, quindi il modo in cui l'archivio dati gestisce questi caratteri dipende dal modo in cui il provider gestisce i caratteri, ad esempio un asterisco (*), un simbolo 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%".

Usando il provider di personalizzazione predefinito, gli PersonalizationStateInfooggetti derivati vengono restituiti in ordine alfabetico e ordinati in base a una combinazione di percorso e nome utente in ordine crescente. L'ordine degli oggetti nell'insieme è 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 è stato impostato su 0 ed pageSize è stato impostato su 25, i dati restituiti saranno i primi 25 voci. Se pageIndex è stato impostato su 1 ed pageSize è stato impostato su 25, i dati restituiti sarebbero voci da 26 a 50. Il totalRecords parametro restituisce il numero totale di record disponibili.

Vedi anche

Si applica a