PersonalizationAdministration.FindUserState Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce un insieme di informazioni di stato sulla personalizzazione per singolo utente in base ai parametri specificati.
Overload
FindUserState(String, String) |
Restituisce un insieme di informazioni di stato sulla personalizzazione per singolo utente in base al nome utente e al percorso della pagina. |
FindUserState(String, String, Int32, Int32, Int32) |
Restituisce un insieme di informazioni di stato sulla personalizzazione per singolo utente in base ai parametri specificati. |
FindUserState(String, String)
Restituisce un insieme di informazioni di stato sulla personalizzazione per singolo utente in base al nome utente e al percorso della pagina.
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch);
static member FindUserState : string * string -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindUserState (pathToMatch As String, usernameToMatch As String) As PersonalizationStateInfoCollection
Parametri
- pathToMatch
- String
Percorso della pagina da mettere in corrispondenza.
- usernameToMatch
- String
Nome utente da mettere in corrispondenza alla cui pagina sono associati i dati sulla personalizzazione.
Restituisce
Un oggetto PersonalizationStateInfoCollection che contiene informazioni di stato sulla personalizzazione per singolo utente.
Eccezioni
pathToMatch
o usernameToMatch
, dopo l'operazione di taglio, è una stringa vuota ("").
-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.
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.
Esempio
Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo FindUserState. L'esempio completo è disponibile nell'argomento panoramica della PersonalizationAdministration classe.
Importante
L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.
protected void Button1_Click(object sender, EventArgs e)
{
if (TextBox3.Text != null)
{
PersonalizationStateInfoCollection findresult;
findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
if (findresult.Count != 0)
{
Label4.Text = findresult.Count + " user(s) found";
Label4.Visible = true;
}
else
{
Label4.Text = "No users found.";
Label4.Visible = true;
}
}
else
{
Label4.Text = "You must enter a user name to find.";
}
}
Commenti
Questo metodo restituisce una raccolta di UserPersonalizationStateInfo istanze in cui il valore del pathToMatch
parametro corrisponde al percorso di una pagina e usernameToMatch
corrisponde a un nome utente con dati di personalizzazione associati a tale pagina. La raccolta contiene solo UserPersonalizationStateInfo 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%".
Analogamente, una ricerca con caratteri jolly su un nome utente parziale potrebbe avere il carattere jolly visualizzato in qualsiasi punto nella stringa di testo della UsernameToMatch proprietà. Ad esempio, per trovare tutti i nomi utente che iniziano con "John", la UsernameToMatch proprietà sarà simile a "John%".
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.
Entrambi pathToMatch
e usernameToMatch
possono essere null
. Il usernameToMatch
parametro può avere virgole (,) perché alcuni archivi dati, ad esempio quelli che eseguono Microsoft SQL Server, consentono virgole come caratteri jolly.
Vedi anche
- WebPartPersonalization
- ASP.NET controlli web part
- Panoramica della personalizzazione delle web part
- Procedura dettagliata: Implementazione della personalizzazione delle web part con un controllo utente
- Personalizzazione web part
Si applica a
FindUserState(String, String, Int32, Int32, Int32)
Restituisce un insieme di informazioni di stato sulla personalizzazione per singolo utente in base ai parametri specificati.
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);
static member FindUserState : string * string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindUserState (pathToMatch As String, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection
Parametri
- pathToMatch
- String
Percorso della pagina da mettere in corrispondenza.
- usernameToMatch
- String
Nome utente da mettere in corrispondenza alla cui pagina sono associati i dati sulla personalizzazione.
- 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
Un oggetto PersonalizationStateInfoCollection che contiene informazioni di stato sulla personalizzazione per singolo utente.
Eccezioni
pathToMatch
o usernameToMatch
, 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.
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.
Esempio
Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo FindUserState. L'esempio completo è disponibile nell'argomento panoramica della PersonalizationAdministration classe.
Importante
L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.
protected void Button1_Click(object sender, EventArgs e)
{
if (TextBox3.Text != null)
{
PersonalizationStateInfoCollection findresult;
findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
if (findresult.Count != 0)
{
Label4.Text = findresult.Count + " user(s) found";
Label4.Visible = true;
}
else
{
Label4.Text = "No users found.";
Label4.Visible = true;
}
}
else
{
Label4.Text = "You must enter a user name to find.";
}
}
Commenti
Questo metodo restituisce una raccolta di UserPersonalizationStateInfo istanze in cui il valore del pathToMatch
parametro corrisponde al percorso di una pagina e usernameToMatch
corrisponde a un nome utente con dati di personalizzazione associati a tale pagina. La raccolta contiene solo UserPersonalizationStateInfo 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 come 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%".
Analogamente, una ricerca con caratteri jolly su un nome utente parziale potrebbe avere il carattere jolly visualizzato in qualsiasi punto nella stringa di testo della UsernameToMatch proprietà. Ad esempio, per trovare tutti i nomi utente che iniziano con "John", la UsernameToMatch proprietà sarà simile a "John%".
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.
Entrambi pathToMatch
e usernameToMatch
possono essere null
. Il usernameToMatch
parametro può avere virgole (,) perché alcuni archivi dati, ad esempio quelli che eseguono Microsoft SQL Server, consentono virgole come caratteri jolly.
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
- WebPartPersonalization
- ASP.NET controlli web part
- Panoramica della personalizzazione delle web part
- Procedura dettagliata: Implementazione della personalizzazione delle web part con un controllo utente
- Personalizzazione web part
Si applica a
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per