PersonalizationAdministration.FindUserState Metodo

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

Restituisce

Oggetto PersonalizationStateInfoCollection che contiene informazioni sullo stato di personalizzazione per utente.

Eccezioni

Esempio

Nell'esempio di codice seguente viene illustrato come usare il FindUserState metodo . L'esempio completo è disponibile nell'argomento panoramica della PersonalizationAdministration classe.

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 istanze in UserPersonalizationStateInfo 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, pertanto 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 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 "~/vdir", la PathToMatch proprietà verrà impostata su "~/vdir%".

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", la UsernameToMatch proprietà sarà simile a "John%".

Usando il provider di personalizzazione predefinito, gli PersonalizationStateInfooggetti derivati da 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.

Sia pathToMatch che 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
• controlli web part ASP.NET
• Panoramica della personalizzazione delle web part
• Procedura dettagliata: implementazione della personalizzazione delle web part con un controllo utente
• Personalizzazione web part

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

Restituisce

Oggetto PersonalizationStateInfoCollection che contiene informazioni sullo stato di personalizzazione per utente.

Eccezioni

Esempio

Nell'esempio di codice seguente viene illustrato come usare il FindUserState metodo . L'esempio completo è disponibile nell'argomento panoramica della PersonalizationAdministration classe.

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 istanze in UserPersonalizationStateInfo 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, pertanto il modo in cui l'archivio dati gestisce questi caratteri dipende dal modo in cui il provider gestisce i caratteri come 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 "~/vdir", la PathToMatch proprietà verrà impostata su "~/vdir%".

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", la UsernameToMatch proprietà sarà simile a "John%".

Usando il provider di personalizzazione predefinito, gli PersonalizationStateInfooggetti derivati da 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.

Sia pathToMatch che 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 sarebbero le prime 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
• controlli web part ASP.NET
• Panoramica della personalizzazione delle web part
• Procedura dettagliata: implementazione della personalizzazione delle web part con un controllo utente
• Personalizzazione web part