PersonalizationAdministration.FindInactiveUserState Methode

  • Referenz

Definition

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

Gibt auf der Grundlage der angegebenen Parameter eine Auflistung der benutzerspezifischen Personalisierungszustandsinformationen für inaktive Benutzer zurück.

Überlädt

FindInactiveUserState(String, String, DateTime)

Gibt auf der Grundlage der angegebenen Parameter eine Auflistung der benutzerspezifischen Personalisierungszustandsinformationen für inaktive Benutzer zurück.
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

Gibt auf der Grundlage der angegebenen Parameter eine Auflistung der benutzerspezifischen Personalisierungszustandsinformationen für inaktive Benutzer zurück.

FindInactiveUserState(String, String, DateTime)

Gibt auf der Grundlage der angegebenen Parameter eine Auflistung der benutzerspezifischen Personalisierungszustandsinformationen für inaktive Benutzer zurück.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState (string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate);
static member FindInactiveUserState : string * string * DateTime -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime) 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.

userInactiveSinceDate
DateTime

Das Datum des letzten Zugriffs auf die Personalisierungsinformationen eines Benutzers.

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.

Hinweise

Diese Methode gibt eine Sammlung von UserPersonalizationStateInfo Instanzen zurück, wobei der Parameterwert mit dem pathToMatch Pfad einer Seite übereinstimmt, mit einem Benutzernamen übereinstimmt, usernameToMatch der dieser Seite Personalisierungsdaten zugeordnet ist, und die Benutzer als inaktiv gelten. Anders ausgedrückt: Für jeden zurückgegebenen Datensatz ist der Eigenschaftswert des LastActivityDate Benutzers kleiner oder gleich userInactiveSinceDate. Die zurückgegebene Auflistung enthält nur UserPersonalizationStateInfo Instanzen.

Diese Methode übergibt Abfrageplatzhalterzeichen an den zugrunde liegenden Datenspeicher. Die Unterstützung von Platzhalterzeichen hängt derzeit davon ab, wie die einzelnen Anbieter Zeichen wie ein Sternchen (*), ein Prozentsymbol (%) oder einen Unterstrich (_) behandeln.

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.

Ebenso kann bei einer Feldhaltersuche für einen teilweisen Benutzernamen das Feldhalterzeichen an jedem Punkt 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.

Wenn userInactiveSinceDate ist MaxValue, dann sind die zurückgegebenen Werte von dieser Methode gleichwertig FindUserState.

Sowohl als usernameToMatch auch pathToMatch können seinnull. Der usernameToMatch Parameter kann Kommas (,) enthalten, da einige Datenspeicher, z. B. microsoft SQL Server, Kommas als Feldhalter zulassen.

Weitere Informationen

Gilt für:

FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

Gibt auf der Grundlage der angegebenen Parameter eine Auflistung der benutzerspezifischen Personalisierungszustandsinformationen für inaktive Benutzer zurück.

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

userInactiveSinceDate
DateTime

Das Datum des letzten Zugriffs auf Personalisierungsinformationen.

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

- 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 Sammlung von UserPersonalizationStateInfo Instanzen zurück, wobei der Parameterwert mit dem pathToMatch Pfad einer Seite übereinstimmt, mit einem Benutzernamen übereinstimmt, usernameToMatch der dieser Seite Personalisierungsdaten zugeordnet ist, und die Benutzer als inaktiv gelten. Anders ausgedrückt: Für jeden zurückgegebenen Datensatz ist der Eigenschaftswert des LastActivityDate Benutzers kleiner oder gleich userInactiveSinceDate. 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 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.

Ebenso kann bei einer Feldhaltersuche für einen teilweisen Benutzernamen das Feldhalterzeichen an jedem Punkt 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.

Wenn userInactiveSinceDate ist MaxValue, dann sind die zurückgegebenen Werte von dieser Methode gleichwertig FindUserState.

Sowohl als usernameToMatch auch pathToMatch können seinnull. Der usernameToMatch Parameter kann Kommas (,) aufweisen, da einige Datenspeicher, z. B. microsoft SQL Server, Kommas als Feldhalter zulassen.

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: