PersonalizationAdministration.FindSharedState Methode

  • Referenz

Definition

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

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

Überlädt

FindSharedState(String)

Gibt eine Auflistung von freigegebenen Personalisierungszustandsinformationen auf der Grundlage des angegebenen Pfades zurück.
FindSharedState(String, Int32, Int32, Int32)

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

FindSharedState(String)

Gibt eine Auflistung von freigegebenen Personalisierungszustandsinformationen auf der Grundlage des angegebenen Pfades zurück.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindSharedState(System::String ^ pathToMatch);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindSharedState (string pathToMatch);
static member FindSharedState : string -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindSharedState (pathToMatch As String) As PersonalizationStateInfoCollection

Parameter

pathToMatch
String

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

Gibt zurück

PersonalizationStateInfoCollection

Eine PersonalizationStateInfoCollection, die freigegebene Personalisierungszustandsinformationen enthält.

Ausnahmen

ArgumentException

pathToMatch 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.

Hinweise

Diese Methode gibt eine Auflistung von UserPersonalizationStateInfo Instanzen zurück, bei denen der pathToMatch Wert mit dem Pfad einer Seite übereinstimmt, die freigegebene Personalisierungsstatusdaten enthält. Die Auflistung enthält nur SharedPersonalizationStateInfo 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 wie ein Sternchen (*), ein Prozentsymbol (%) oder einen Unterstrich (_) verarbeitet.

Normalerweise können Sie bei SQL-kompatiblen Datenspeichern eine Feldhaltersuche für einen teiligen Pfad ausführen, wobei das Feldhalterzeichen 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.

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.

Der pathToMatch Parameter kann sein null. Wenn auf nullfestgelegt ist, wird der Parameter beim Ausführen von Abfragen ignoriert.

Weitere Informationen

Gilt für:

FindSharedState(String, Int32, Int32, Int32)

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

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindSharedState(System::String ^ pathToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindSharedState (string pathToMatch, int pageIndex, int pageSize, out int totalRecords);
static member FindSharedState : string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindSharedState (pathToMatch 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.

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 freigegebene Personalisierungszustandsinformationen enthält.

Ausnahmen

ArgumentException

pathToMatch 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.

Hinweise

Diese Methode gibt eine Auflistung von UserPersonalizationStateInfo Instanzen zurück, bei denen der pathToMatch Wert mit dem Pfad einer Seite übereinstimmt, die freigegebene Personalisierungsstatusdaten enthält. Die Auflistung enthält nur SharedPersonalizationStateInfo 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 wie ein Sternchen (*), ein Prozentsymbol (%) oder einen Unterstrich (_) verarbeitet.

Normalerweise können Sie bei SQL-kompatiblen Datenspeichern eine Feldhaltersuche für einen teiligen Pfad ausführen, wobei das Feldhalterzeichen 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.

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.

Der pathToMatch Parameter kann sein null. Wenn auf nullfestgelegt ist, wird der Parameter beim Ausführen von Abfragen ignoriert.

Die zurückgegebenen Daten werden durch pageIndex und pageSizeeingeschränkt, wobei steuerelemente, welche pageIndex Datensätze zurückgegeben werden sollen, und pageSize die Anzahl der zurückzugebenden Datensätze steuert. Wenn pageIndex beispielsweise auf 0 festgelegt und pageSize auf 25 festgelegt wurde, sind die zurückgegebenen Daten die ersten 25 Einträge. Wenn pageIndex auf 1 festgelegt und pageSize 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: