PersonalizationAdministration.FindInactiveUserState Metod

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

Parametrar

Returer

En PersonalizationStateInfoCollection som innehåller information om personanpassningstillstånd per användare.

Undantag

Kommentarer

Den här metoden returnerar en samling UserPersonalizationStateInfo instanser, information om personanpassningstillstånd per användare där pathToMatch parametervärdet matchar sökvägen för en sida, usernameToMatch matchar ett användarnamn som har personanpassningsdata som är associerade med den sidan och användarna anses vara inaktiva. För varje returnerad post är med andra ord användarens egenskapsvärde LastActivityDate mindre än eller lika med userInactiveSinceDate. Den returnerade samlingen innehåller endast UserPersonalizationStateInfo instanser.

Den här metoden skickar jokertecken för frågor till det underliggande datalagret. Stöd för jokertecken beror för närvarande på hur varje provider hanterar tecken, till exempel en asterisk (*), en procentsymbol (%) eller ett understreck (_).

För SQL-kompatibla datalager kan du normalt utföra en sökning med jokertecken på en partiell sökväg med jokertecknet som visas i början, slutet eller i mitten av söksträngstexten PathToMatch i egenskapen. Om du till exempel vill hitta alla sökvägar som börjar med "~/vdir" PathToMatch skulle egenskapen vara inställd på "~/vdir%".

På samma sätt kan en jokerteckensökning på ett partiellt användarnamn få jokertecknet att visas när som helst i egenskapens UsernameToMatch textsträng. Om du till exempel vill hitta alla användarnamn som börjar med "John" UsernameToMatch ser egenskapen ut som "John%".

Med standardprovidern för anpassning returneras -derived-objekten PersonalizationStateInfoi alfabetisk ordning och sorteras efter en kombination av sökväg och användarnamn i stigande ordning. Ordningen på objekten i samlingen bestäms av providern.

Om userInactiveSinceDate är MaxValuemotsvarar FindUserStatede returnerade värdena från den här metoden .

Både pathToMatch och usernameToMatch kan vara null. Parametern usernameToMatch kan innehålla kommatecken (,) eftersom vissa datalager, till exempel de som kör Microsoft SQL Server, tillåter kommatecken som jokertecken.

Se även

• WebPartPersonalization
• ASP.NET webbdelskontroller
• Översikt över anpassning av webbdelar
• Genomgång: Implementera anpassning av webbdelar med en användarkontroll
• Anpassning av webbdelar

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

Parametrar

Returer

En PersonalizationStateInfoCollection som innehåller information om personanpassningstillstånd per användare.

Undantag

Kommentarer

Den här metoden returnerar en samling UserPersonalizationStateInfo instanser, information om personanpassningstillstånd per användare där pathToMatch parametervärdet matchar sökvägen för en sida, usernameToMatch matchar ett användarnamn som har personanpassningsdata som är associerade med den sidan och användarna anses vara inaktiva. För varje returnerad post är med andra ord användarens egenskapsvärde LastActivityDate mindre än eller lika med userInactiveSinceDate. Samlingen innehåller endast UserPersonalizationStateInfo instanser.

Den här metoden skickar jokertecken för parametern till den underliggande personanpassningsprovidern, så hur datalagret hanterar dessa tecken beror på hur providern hanterar tecken som en asterisk (*), en procentsymbol (%) eller ett understreck (_).

För SQL-kompatibla datalager kan du normalt utföra en sökning med jokertecken på en partiell sökväg med jokertecknet som visas i början, slutet eller i mitten av söksträngstexten PathToMatch i egenskapen. Om du till exempel vill hitta alla sökvägar som börjar med "~/vdir" PathToMatch skulle egenskapen vara inställd på "~/vdir%".

På samma sätt kan en jokerteckensökning på ett partiellt användarnamn få jokertecknet att visas när som helst i egenskapens UsernameToMatch textsträng. Om du till exempel vill hitta alla användarnamn som börjar med "John" UsernameToMatch ser egenskapen ut som "John%".

Med standardprovidern för anpassning returneras -derived-objekten PersonalizationStateInfoi alfabetisk ordning och sorteras efter en kombination av sökväg och användarnamn i stigande ordning. Ordningen på objekten i samlingen bestäms av providern.

Om userInactiveSinceDate är MaxValuemotsvarar FindUserStatede returnerade värdena från den här metoden .

Både pathToMatch och usernameToMatch kan vara null. Parametern usernameToMatch kan ha kommatecken (,) eftersom vissa datalager, till exempel de som kör Microsoft SQL Server, tillåter kommatecken som jokertecken.

De data som returneras begränsas av pageIndex och pageSize, där pageIndex styr vilka poster som ska returneras och pageSize styr antalet poster som ska returneras. Om pageIndex till exempel har angetts till 0 och pageSize har angetts till 25, skulle de data som returneras vara de första 25 posterna. Om pageIndex värdet var 1 och pageSize var inställt på 25 skulle de data som returneras vara posterna 26 till 50. Parametern totalRecords returnerar det totala antalet poster som är tillgängliga.

Se även

• WebPartPersonalization
• ASP.NET webbdelskontroller
• Översikt över anpassning av webbdelar
• Genomgång: Implementera anpassning av webbdelar med en användarkontroll
• Anpassning av webbdelar