PersonalizationAdministration.FindSharedState Metod

Definition

Namnområde:
System.Web.UI.WebControls.WebParts
Sammansättning:
System.Web.dll

Returnerar en samling information om delat anpassningstillstånd baserat på de angivna parametrarna.

Överlagringar

Name Description
FindSharedState(String)

Returnerar en samling information om tillståndet för delad anpassning baserat på den angivna sökvägen.
FindSharedState(String, Int32, Int32, Int32)

Returnerar en samling information om delat anpassningstillstånd baserat på de angivna parametrarna.

FindSharedState(String)

Returnerar en samling information om tillståndet för delad anpassning baserat på den angivna sökvägen.

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

Parametrar

pathToMatch
String

Sökvägen till sidan som ska matchas.

Returer

PersonalizationStateInfoCollection

En PersonalizationStateInfoCollection som innehåller information om delat personanpassningstillstånd.

Undantag

ArgumentException

pathToMatch är en tom sträng ("") före eller efter trimning.

-eller-

Providern för en personanpassningsprovider som definierats i konfigurationen är inte av rätt typ.

-eller-

Längden på strängen för en parameter är större än 256 tecken.

ConfigurationErrorsException

Ett konfigurationsfel inträffade vid försök att skapa och initiera en instans av en av de konfigurerade personanpassningsprovidrar.

-eller-

Det gick inte att hitta standardprovidern för anpassning som definierats i konfigurationen.

Kommentarer

Den här metoden returnerar en samling UserPersonalizationStateInfo instanser där pathToMatch värdet matchar sökvägen till en sida som har delade personanpassningstillståndsdata. Samlingen innehåller endast SharedPersonalizationStateInfo 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%".

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.

Parametern pathToMatch kan vara null. Om den är inställd nullpå ignoreras parametern när du utför frågor.

Se även

Gäller för

FindSharedState(String, Int32, Int32, Int32)

Returnerar en samling information om delat anpassningstillstånd baserat på de angivna parametrarna.

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

Parametrar

pathToMatch
String

Sökvägen till sidan som ska matchas.

pageIndex
Int32

Det nollbaserade indexet för sidan med resultat som ska returneras.

pageSize
Int32

Antalet poster som ska returneras.

totalRecords
Int32

Det totala antalet tillgängliga poster.

Returer

PersonalizationStateInfoCollection

En PersonalizationStateInfoCollection som innehåller information om delat personanpassningstillstånd.

Undantag

ArgumentException

pathToMatch före eller efter trimning är en tom sträng ("").

-eller-

pageIndex är mindre än noll.

-eller-

pageSize är mindre än eller lika med noll.

-eller-

Kombinationen av pageIndex och pageSize överskrider Int32.MaxValue.

-eller-

Providern för en personanpassningsprovider som definierats i konfigurationen är inte av rätt typ.

-eller-

Längden på strängen för en parameter är större än 256 tecken.

ConfigurationErrorsException

Ett konfigurationsfel inträffade vid försök att skapa och initiera en instans av en av de konfigurerade personanpassningsprovidrar.

-eller-

Det gick inte att hitta standardprovidern för anpassning som definierats i konfigurationen.

Kommentarer

Den här metoden returnerar en samling UserPersonalizationStateInfo instanser där pathToMatch värdet matchar sökvägen till en sida som har delade personanpassningstillståndsdata. Samlingen innehåller endast SharedPersonalizationStateInfo 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%".

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.

Parametern pathToMatch kan vara null. Om den är inställd nullpå ignoreras parametern när du utför frågor.

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

Gäller för