PersonalizationAdministration.FindInactiveUserState Methode

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

Gibt zurück

Eine PersonalizationStateInfoCollection, die benutzerspezifische Personalisierungszustandsinformationen enthält.

Ausnahmen

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. solche, die Microsoft SQL Server ausführen, Kommas als Feldhalter zulassen.

Weitere Informationen

• WebPartPersonalization
• ASP.NET Webpart-Steuerelemente
• Übersicht über die Personalisierung von Webparts
• Exemplarische Vorgehensweise: Implementieren der Webpart-Personalisierung mit einem Benutzersteuerelement
• Personalisierung von Webparts

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

Gibt zurück

Eine PersonalizationStateInfoCollection, die benutzerspezifische Personalisierungszustandsinformationen enthält.

Ausnahmen

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. diejenigen, die Microsoft SQL Server ausführen, 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

• WebPartPersonalization
• ASP.NET Webpart-Steuerelemente
• Übersicht über die Personalisierung von Webparts
• Exemplarische Vorgehensweise: Implementieren der Webpart-Personalisierung mit einem Benutzersteuerelement
• Personalisierung von Webparts