Freigeben über

PersonalizationAdministration.FindUserState Methode

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Gibt eine Auflistung von benutzerspezifischen Personalisierungszustandsinformationen auf der Grundlage der angegebenen Parameter zurück.

Überlädt

FindUserState(String, String)

Gibt eine Auflistung von benutzerspezifischen Personalisierungszustandsinformationen auf der Grundlage des Benutzernamens und des Seitenpfades zurück.
FindUserState(String, String, Int32, Int32, Int32)

Gibt eine Auflistung von benutzerspezifischen Personalisierungszustandsinformationen auf der Grundlage der angegebenen Parameter zurück.

FindUserState(String, String)

Gibt eine Auflistung von benutzerspezifischen Personalisierungszustandsinformationen auf der Grundlage des Benutzernamens und des Seitenpfades zurück.

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

Parameter

pathToMatch
String

Der Pfad der Seite, mit dem eine Übereinstimmung gefunden werden soll.

usernameToMatch
String

Der Benutzername mit den der Seite zugeordneten Personalisierungsdaten, mit dem eine Übereinstimmung gefunden werden soll.

Gibt zurück

PersonalizationStateInfoCollection

Eine PersonalizationStateInfoCollection, die benutzerspezifische Personalisierungszustandsinformationen enthält.

Ausnahmen

ArgumentException

pathToMatch oder usernameToMatch entspricht vor oder nach dem Verkürzen einer leeren Zeichenfolge ("").

- oder -

Der Anbieter für einen in der Konfiguration definierten Personalisierungsanbieter weist nicht den richtigen Typ auf.

- oder -

Die Länge der Zeichenfolge eines beliebigen Parameters beträgt mehr als 256 Zeichen.

ConfigurationErrorsException

Beim Versuch, eine Instanz eines konfigurierten Personalisierungsanbieters zu erstellen und zu initialisieren, ist eine Konfigurationsausnahme aufgetreten.

- oder -

Der in der Konfiguration definierte standardmäßige Personalisierungsanbieter wurde nicht gefunden.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die FindUserState-Methode verwenden. Das vollständige Beispiel finden Sie im PersonalizationAdministration Thema Klassenübersicht.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.

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

}

Hinweise

Diese Methode gibt eine Auflistung von UserPersonalizationStateInfo Instanzen zurück, bei denen der pathToMatch Parameterwert mit dem Pfad einer Seite übereinstimmt und usernameToMatch mit einem Benutzernamen übereinstimmt, der dieser Seite zugeordnete Personalisierungsdaten enthält. Die Auflistung enthält nur UserPersonalizationStateInfo Instanzen.

Diese Methode übergibt Parameterplatzhalterzeichen an den zugrunde liegenden Personalisierungsanbieter, sodass die Art und Weise, wie der Datenspeicher diese Zeichen behandelt, davon abhängt, wie der Anbieter Zeichen wie ein Sternchen (*), ein Prozentsymbol (%)oder einen Unterstrich (_) behandelt.

Normalerweise können Sie bei SQL-kompatiblen Datenspeichern eine Wildcardsuche für einen Teilpfad ausführen, wobei das Wildcardzeichen am Anfang, am Ende oder in der Mitte des Suchzeichenfolgentexts in der PathToMatch -Eigenschaft angezeigt wird. Um beispielsweise alle Pfade zu finden, die mit "~/vdir" beginnen, wird die PathToMatch -Eigenschaft auf "~/vdir%" festgelegt.

Ebenso kann bei einer Wildcardsuche für einen teilweisen Benutzernamen das Wildcardzeichen an jeder Stelle in der Textzeichenfolge der UsernameToMatch -Eigenschaft angezeigt werden. Um beispielsweise alle Benutzernamen zu finden, die mit "John" beginnen, würde die UsernameToMatch Eigenschaft wie "John%" aussehen.

Mithilfe des Standardpersonalisierungsanbieters werden die PersonalizationStateInfoabgeleiteten Objekte in alphabetischer Reihenfolge zurückgegeben und nach einer Kombination aus Pfad und Benutzername in aufsteigender Reihenfolge sortiert. Die Reihenfolge der Objekte in der Auflistung wird vom Anbieter bestimmt.

Sowohl als usernameToMatch auch pathToMatch können seinnull. Der usernameToMatch Parameter kann Kommas (,) aufweisen, da einige Datenspeicher, z. B. solche, die Microsoft SQL Server ausführen, Kommas als Wildcardzeichen zulassen.

Weitere Informationen

Gilt für:

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

Gibt eine Auflistung von benutzerspezifischen Personalisierungszustandsinformationen auf der Grundlage der angegebenen Parameter zurück.

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

Parameter

pathToMatch
String

Der Pfad der Seite, mit dem eine Übereinstimmung gefunden werden soll.

usernameToMatch
String

Der Benutzername mit den der Seite zugeordneten Personalisierungsdaten, mit dem eine Übereinstimmung gefunden werden soll.

pageIndex
Int32

Der nullbasierte Index der Seite mit den zurückzugebenden Ergebnissen.

pageSize
Int32

Die Anzahl der zurückzugebenden Datensätze.

totalRecords
Int32

Die Gesamtzahl der verfügbaren Datensätze.

Gibt zurück

PersonalizationStateInfoCollection

Eine PersonalizationStateInfoCollection, die benutzerspezifische Personalisierungszustandsinformationen enthält.

Ausnahmen

ArgumentException

pathToMatch oder usernameToMatch entspricht vor oder nach dem Verkürzen einer leeren Zeichenfolge ("").

- oder -

pageIndex ist kleiner als Null.

- oder -

pageSize ist kleiner oder gleich 0 (null).

- oder -

Die Kombination von pageIndex und pageSize überschreitet Int32.MaxValue.

- oder -

Der Anbieter für einen in der Konfiguration definierten Personalisierungsanbieter weist nicht den richtigen Typ auf.

- oder -

Die Länge der Zeichenfolge eines beliebigen Parameters beträgt mehr als 256 Zeichen.

ConfigurationErrorsException

Beim Versuch, eine Instanz eines konfigurierten Personalisierungsanbieters zu erstellen und zu initialisieren, ist eine Konfigurationsausnahme aufgetreten.

- oder -

Der in der Konfiguration definierte standardmäßige Personalisierungsanbieter wurde nicht gefunden.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die FindUserState-Methode verwenden. Das vollständige Beispiel finden Sie im PersonalizationAdministration Thema Klassenübersicht.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.

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

}

Hinweise

Diese Methode gibt eine Auflistung von UserPersonalizationStateInfo Instanzen zurück, bei denen der pathToMatch Parameterwert mit dem Pfad einer Seite und usernameToMatch einem Benutzernamen übereinstimmt, der dieser Seite zugeordnete Personalisierungsdaten enthält. Die Auflistung enthält nur UserPersonalizationStateInfo Instanzen.

Diese Methode übergibt Parameterplatzhalterzeichen an den zugrunde liegenden Personalisierungsanbieter. Die Verarbeitung dieser Zeichen durch den Datenspeicher hängt daher davon ab, wie der Anbieter Zeichen als Sternchen (*), Prozentsymbol (%)oder Unterstrich (_) behandelt.

Normalerweise können Sie bei SQL-kompatiblen Datenspeichern eine Wildcardsuche für einen Teilpfad ausführen, wobei das Wildcardzeichen am Anfang, am Ende oder in der Mitte des Suchzeichenfolgentexts in der PathToMatch -Eigenschaft angezeigt wird. Um beispielsweise alle Pfade zu finden, die mit "~/vdir" beginnen, wird die PathToMatch -Eigenschaft auf "~/vdir%" festgelegt.

Ebenso kann bei einer Wildcardsuche für einen teilweisen Benutzernamen das Wildcardzeichen an jeder Stelle in der Textzeichenfolge der UsernameToMatch -Eigenschaft angezeigt werden. Um beispielsweise alle Benutzernamen zu finden, die mit "John" beginnen, würde die UsernameToMatch Eigenschaft wie "John%" aussehen.

Mithilfe des Standardpersonalisierungsanbieters werden die PersonalizationStateInfoabgeleiteten Objekte in alphabetischer Reihenfolge zurückgegeben und nach einer Kombination aus Pfad und Benutzername in aufsteigender Reihenfolge sortiert. Die Reihenfolge der Objekte in der Auflistung wird vom Anbieter bestimmt.

Sowohl als usernameToMatch auch pathToMatch können seinnull. Der usernameToMatch Parameter kann Kommas (,) aufweisen, da einige Datenspeicher, z. B. solche, die Microsoft SQL Server ausführen, Kommas als Wildcardzeichen zulassen.

Die zurückgegebenen Daten werden durch pageIndex und pageSizeeingeschränkt, wobei pageIndex steuert, welche Datensätze zurückgegeben werden sollen, und pageSize die Anzahl der zurückzugebenden Datensätze. Wenn pageIndex beispielsweise auf 0 pageSize und 25 festgelegt wurde, werden die ersten 25 Einträge zurückgegeben. Wenn pageIndex auf 1 pageSize und auf 25 festgelegt wurde, sind die zurückgegebenen Daten die Einträge 26 bis 50. Der totalRecords Parameter gibt die Gesamtzahl der verfügbaren Datensätze zurück.

Weitere Informationen

Gilt für: