PersonalizationAdministration.FindUserState Metod

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

Parametrar

Returer

En PersonalizationStateInfoCollection som innehåller information om personanpassningstillstånd per användare.

Undantag

Exempel

I följande kodexempel visas hur du använder FindUserState metoden. Det fullständiga exemplet finns i PersonalizationAdministration avsnittet klassöversikt.

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.";
  }

}

Kommentarer

Den här metoden returnerar en samling UserPersonalizationStateInfo instanser där pathToMatch parametervärdet matchar sökvägen till en sida och usernameToMatch matchar ett användarnamn som har personanpassningsdata associerade med den sidan. Samlingen innehåller endast UserPersonalizationStateInfo instanser.

Den här metoden skickar jokertecken för parametern till den underliggande personanpassningsprovidern, så hur datalagret hanterar dessa tecken beror på hur providern hanterar tecken som en asterisk (*), en procentsymbol (%) eller ett understreck (_).

För SQL-kompatibla datalager kan du normalt utföra en sökning med jokertecken på en partiell sökväg med jokertecknet som visas i början, slutet eller i mitten av söksträngstexten PathToMatch i egenskapen. Om du till exempel vill hitta alla sökvägar som börjar med "~/vdir" PathToMatch skulle egenskapen vara inställd på "~/vdir%".

På samma sätt kan en jokerteckensökning på ett partiellt användarnamn få jokertecknet att visas när som helst i egenskapens UsernameToMatch textsträng. Om du till exempel vill hitta alla användarnamn som börjar med "John" UsernameToMatch ser egenskapen ut som "John%".

Med standardprovidern för anpassning returneras -derived-objekten PersonalizationStateInfoi alfabetisk ordning och sorteras efter en kombination av sökväg och användarnamn i stigande ordning. Ordningen på objekten i samlingen bestäms av providern.

Både pathToMatch och usernameToMatch kan vara null. Parametern usernameToMatch kan ha kommatecken (,) eftersom vissa datalager, till exempel de som kör Microsoft SQL Server, tillåter kommatecken som jokertecken.

Se även

• WebPartPersonalization
• ASP.NET webbdelskontroller
• Översikt över anpassning av webbdelar
• Genomgång: Implementera anpassning av webbdelar med en användarkontroll
• Anpassning av webbdelar

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

Parametrar

Returer

En PersonalizationStateInfoCollection som innehåller information om personanpassningstillstånd per användare.

Undantag

Exempel

I följande kodexempel visas hur du använder FindUserState metoden. Det fullständiga exemplet finns i PersonalizationAdministration avsnittet klassöversikt.

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.";
  }

}

Kommentarer

Den här metoden returnerar en samling UserPersonalizationStateInfo instanser där pathToMatch parametervärdet matchar sökvägen till en sida och usernameToMatch matchar ett användarnamn som har personanpassningsdata associerade med den sidan. Samlingen innehåller endast UserPersonalizationStateInfo instanser.

Den här metoden skickar jokertecken för parametern till den underliggande personanpassningsprovidern, så hur datalagret hanterar dessa tecken beror på hur providern hanterar tecken som en asterisk (*), en procentsymbol (%) eller ett understreck (_).

För SQL-kompatibla datalager kan du normalt utföra en sökning med jokertecken på en partiell sökväg med jokertecknet som visas i början, slutet eller i mitten av söksträngstexten PathToMatch i egenskapen. Om du till exempel vill hitta alla sökvägar som börjar med "~/vdir" PathToMatch skulle egenskapen vara inställd på "~/vdir%".

På samma sätt kan en jokerteckensökning på ett partiellt användarnamn få jokertecknet att visas när som helst i egenskapens UsernameToMatch textsträng. Om du till exempel vill hitta alla användarnamn som börjar med "John" UsernameToMatch ser egenskapen ut som "John%".

Med standardprovidern för anpassning returneras -derived-objekten PersonalizationStateInfoi alfabetisk ordning och sorteras efter en kombination av sökväg och användarnamn i stigande ordning. Ordningen på objekten i samlingen bestäms av providern.

Både pathToMatch och usernameToMatch kan vara null. Parametern usernameToMatch kan ha kommatecken (,) eftersom vissa datalager, till exempel de som kör Microsoft SQL Server, tillåter kommatecken som jokertecken.

De data som returneras begränsas av pageIndex och pageSize, där pageIndex styr vilka poster som ska returneras och pageSize styr antalet poster som ska returneras. Om pageIndex till exempel har angetts till 0 och pageSize har angetts till 25, skulle de data som returneras vara de första 25 posterna. Om pageIndex värdet var 1 och pageSize var inställt på 25 skulle de data som returneras vara posterna 26 till 50. Parametern totalRecords returnerar det totala antalet poster som är tillgängliga.

Se även

• WebPartPersonalization
• ASP.NET webbdelskontroller
• Översikt över anpassning av webbdelar
• Genomgång: Implementera anpassning av webbdelar med en användarkontroll
• Anpassning av webbdelar