PersonalizationAdministration.FindUserState Methode

Definitie

Naamruimte:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Retourneert een verzameling persoonlijke statusgegevens per gebruiker op basis van de opgegeven parameters.

Overloads

Name	Description
FindUserState(String, String)	Retourneert een verzameling statusgegevens per gebruiker op basis van de gebruikersnaam en het paginapad.
FindUserState(String, String, Int32, Int32, Int32)	Retourneert een verzameling persoonlijke statusgegevens per gebruiker op basis van de opgegeven parameters.

FindUserState(String, String)

Retourneert een verzameling statusgegevens per gebruiker op basis van de gebruikersnaam en het paginapad.

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

Parameters

pathToMatch: String

Het pad van de pagina dat moet worden vergeleken.

usernameToMatch: String

De gebruikersnaam die overeenkomt met de persoonlijke gegevens die aan de pagina zijn gekoppeld.

Retouren

PersonalizationStateInfoCollection

Een PersonalizationStateInfoCollection met statusgegevens per gebruiker.

Uitzonderingen

ArgumentException

pathToMatch of usernameToMatch voor of na het bijsnijden is een lege tekenreeks ("").

– of –

De provider voor een personalisatieprovider die in de configuratie is gedefinieerd, is niet van het juiste type.

– of –

De lengte van de tekenreeks van een parameter is groter dan 256 tekens.

ConfigurationErrorsException

Er is een configuratie-uitzondering opgetreden bij het maken en initialiseren van een exemplaar van een van de geconfigureerde personalisatieproviders.

– of –

De standaardprovider voor persoonlijke instellingen die in de configuratie is gedefinieerd, is niet gevonden.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de FindUserState methode gebruikt. Het volledige voorbeeld vindt u in het onderwerp over het PersonalizationAdministration klassenoverzicht.

Important

Dit voorbeeld heeft een tekstvak dat gebruikersinvoer accepteert. Dit is een mogelijke beveiligingsrisico. Standaard valideren ASP.NET webpagina's dat gebruikersinvoer geen script- of HTML-elementen bevat. Zie Overzicht van Script Exploits voor meer informatie.

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

}

Opmerkingen

Deze methode retourneert een verzameling UserPersonalizationStateInfo exemplaren waarbij de pathToMatch parameterwaarde overeenkomt met het pad van een pagina en usernameToMatch overeenkomt met een gebruikersnaam die persoonlijke gegevens bevat die aan die pagina zijn gekoppeld. De verzameling bevat alleen UserPersonalizationStateInfo exemplaren.

Deze methode geeft parameter-jokertekens door aan de onderliggende personalisatieprovider, dus hoe het gegevensarchief deze tekens verwerkt, is afhankelijk van hoe de provider tekens verwerkt, zoals een sterretje (*), een procentsymbool (%) of een onderstrepingsteken (_).

Normaal gesproken kunt u voor sql-compatibele gegevensarchieven een zoekopdracht met jokertekens uitvoeren op een gedeeltelijk pad, waarbij het jokerteken aan het begin, het einde of het midden van de tekenreekstekst in de PathToMatch eigenschap wordt weergegeven. Als u bijvoorbeeld alle paden wilt vinden die beginnen met ~/vdir, wordt de PathToMatch eigenschap ingesteld op '~/vdir%'.

Op dezelfde manier kan bij een zoekopdracht met jokertekens op een gedeeltelijke gebruikersnaam het jokerteken op elk punt in de tekenreeks van de UsernameToMatch eigenschap worden weergegeven. Als u bijvoorbeeld alle gebruikersnamen wilt zoeken die beginnen met 'John', ziet de UsernameToMatch eigenschap eruit als 'John%'.

Met behulp van de standaardprovider voor persoonlijke instellingen worden de PersonalizationStateInfo-afgeleide objecten in alfabetische volgorde geretourneerd en gesorteerd op een combinatie van pad en gebruikersnaam in oplopende volgorde. De volgorde van de objecten in de verzameling wordt bepaald door de provider.

Beide pathToMatch en usernameToMatch kunnen zijn null. De parameter usernameToMatch kan komma's (,) bevatten omdat sommige gegevensarchieven, zoals die waarop Microsoft SQL Server worden uitgevoerd, komma's als jokertekens toestaan.

Zie ook

Van toepassing op

FindUserState(String, String, Int32, Int32, Int32)

Retourneert een verzameling persoonlijke statusgegevens per gebruiker op basis van de opgegeven parameters.

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

Parameters

pathToMatch: String

Het pad van de pagina dat moet worden vergeleken.

usernameToMatch: String

De gebruikersnaam die overeenkomt met de persoonlijke gegevens die aan de pagina zijn gekoppeld.

pageIndex: Int32

De op nul gebaseerde index van de pagina met resultaten die moeten worden geretourneerd.

pageSize: Int32

Het aantal records dat moet worden geretourneerd.

totalRecords: Int32

Het totale aantal of de records die beschikbaar zijn.

Retouren

PersonalizationStateInfoCollection

Een PersonalizationStateInfoCollection met statusgegevens per gebruiker.

Uitzonderingen

ArgumentException

pathToMatch of usernameToMatch voor of na het bijsnijden is een lege tekenreeks ("").

– of –

pageIndex is kleiner dan nul.

– of –

pageSize is kleiner dan of gelijk aan nul.

– of –

De combinatie van pageIndex en pageSize overschrijdt Int32.MaxValue.

– of –

De provider voor een personalisatieprovider die in de configuratie is gedefinieerd, is niet van het juiste type.

– of –

De lengte van de tekenreeks van een parameter is groter dan 256 tekens.

ConfigurationErrorsException

Er is een configuratie-uitzondering opgetreden bij het maken en initialiseren van een exemplaar van een van de geconfigureerde personalisatieproviders.

– of –

De standaardprovider voor persoonlijke instellingen die in de configuratie is gedefinieerd, is niet gevonden.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de FindUserState methode gebruikt. Het volledige voorbeeld vindt u in het onderwerp over het PersonalizationAdministration klassenoverzicht.

Important

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

}

Opmerkingen

Deze methode geeft parameter-jokertekens door aan de onderliggende personalisatieprovider, dus hoe het gegevensarchief deze tekens verwerkt, is afhankelijk van hoe de provider tekens verwerkt als een sterretje (*), een procentsymbool (%) of een onderstrepingsteken (_).

De geretourneerde gegevens worden beperkt door pageIndex en pageSize, waarbij bepaalt welke pageIndex records moeten worden geretourneerd en pageSize het aantal records dat moet worden geretourneerd. Als pageIndex de waarde bijvoorbeeld is ingesteld op 0 en pageSize is ingesteld op 25, zijn de geretourneerde gegevens de eerste 25 vermeldingen. Als pageIndex de waarde is ingesteld op 1 en pageSize is ingesteld op 25, worden de geretourneerde gegevens 26 tot 50. De totalRecords parameter retourneert het totale aantal records dat beschikbaar is.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?