PersonalizationAdministration.FindSharedState Methode

Definitie

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

Retourneert een verzameling gedeelde persoonlijke statusgegevens op basis van de opgegeven parameters.

Overloads

Name Description
FindSharedState(String)

Hiermee wordt een verzameling gedeelde persoonlijke statusgegevens geretourneerd op basis van het opgegeven pad.
FindSharedState(String, Int32, Int32, Int32)

Retourneert een verzameling gedeelde persoonlijke statusgegevens op basis van de opgegeven parameters.

FindSharedState(String)

Hiermee wordt een verzameling gedeelde persoonlijke statusgegevens geretourneerd op basis van het opgegeven pad.

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

Parameters

pathToMatch
String

Het pad van de pagina dat moet worden vergeleken.

Retouren

PersonalizationStateInfoCollection

Een PersonalizationStateInfoCollection met gedeelde statusgegevens voor persoonlijke instellingen.

Uitzonderingen

ArgumentException

pathToMatch is een lege tekenreeks ("") vóór of na het bijsnijden.

– of –

De provider voor een personalisatieprovider die in de configuratie is gedefinieerd, is niet van het juiste type.

– of –

De lengte van de tekenreeks van een parameter is groter dan 256 tekens.

ConfigurationErrorsException

Er is een configuratie-uitzondering opgetreden bij het maken en initialiseren van een exemplaar van een van de geconfigureerde personalisatieproviders.

– of –

De standaardprovider voor persoonlijke instellingen die in de configuratie is gedefinieerd, is niet gevonden.

Opmerkingen

Deze methode retourneert een verzameling UserPersonalizationStateInfo exemplaren waarbij de pathToMatch waarde overeenkomt met het pad van een pagina met gedeelde persoonlijke statusgegevens. De verzameling bevat alleen SharedPersonalizationStateInfo exemplaren.

Deze methode geeft parameter-jokertekens door aan de onderliggende personalisatieprovider, dus hoe het gegevensarchief deze tekens verwerkt, is afhankelijk van hoe de provider tekens verwerkt, zoals een sterretje (*), een procentsymbool (%) of een onderstrepingsteken (_).

Normaal gesproken kunt u voor sql-compatibele gegevensarchieven een zoekopdracht met jokertekens uitvoeren op een gedeeltelijk pad, waarbij het jokerteken aan het begin, het einde of het midden van de tekenreekstekst in de PathToMatch eigenschap wordt weergegeven. Als u bijvoorbeeld alle paden wilt vinden die beginnen met ~/vdir, wordt de PathToMatch eigenschap ingesteld op '~/vdir%'.

Met behulp van de standaardprovider voor persoonlijke instellingen worden de PersonalizationStateInfo-afgeleide objecten in alfabetische volgorde geretourneerd en gesorteerd op een combinatie van pad en gebruikersnaam in oplopende volgorde. De volgorde van de objecten in de verzameling wordt bepaald door de provider.

De pathToMatch parameter kan zijn null. Als deze optie is ingesteld null, wordt de parameter genegeerd bij het uitvoeren van query's.

Zie ook

Van toepassing op

FindSharedState(String, Int32, Int32, Int32)

Retourneert een verzameling gedeelde persoonlijke statusgegevens op basis van de opgegeven parameters.

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

Parameters

pathToMatch
String

Het pad van de pagina dat moet worden vergeleken.

pageIndex
Int32

De op nul gebaseerde index van de pagina met resultaten die moeten worden geretourneerd.

pageSize
Int32

Het aantal records dat moet worden geretourneerd.

totalRecords
Int32

Het totale aantal beschikbare records.

Retouren

PersonalizationStateInfoCollection

Een PersonalizationStateInfoCollection met gedeelde statusgegevens voor persoonlijke instellingen.

Uitzonderingen

ArgumentException

pathToMatch voor of na bijsnijden is een lege tekenreeks ("").

– of –

pageIndex is kleiner dan nul.

– of –

pageSize is kleiner dan of gelijk aan nul.

– of –

De combinatie van pageIndex en pageSize overschrijdt Int32.MaxValue.

– of –

De provider voor een personalisatieprovider die in de configuratie is gedefinieerd, is niet van het juiste type.

– of –

De lengte van de tekenreeks van een parameter is groter dan 256 tekens.

ConfigurationErrorsException

Er is een configuratie-uitzondering opgetreden bij het maken en initialiseren van een exemplaar van een van de geconfigureerde personalisatieproviders.

– of –

De standaardprovider voor persoonlijke instellingen die in de configuratie is gedefinieerd, is niet gevonden.

Opmerkingen

Deze methode retourneert een verzameling UserPersonalizationStateInfo exemplaren waarbij de pathToMatch waarde overeenkomt met het pad van een pagina met gedeelde persoonlijke statusgegevens. De verzameling bevat alleen SharedPersonalizationStateInfo exemplaren.

Deze methode geeft parameter-jokertekens door aan de onderliggende personalisatieprovider, dus hoe het gegevensarchief deze tekens verwerkt, is afhankelijk van hoe de provider tekens verwerkt, zoals een sterretje (*), een procentsymbool (%) of een onderstrepingsteken (_).

Normaal gesproken kunt u voor sql-compatibele gegevensarchieven een zoekopdracht met jokertekens uitvoeren op een gedeeltelijk pad, waarbij het jokerteken aan het begin, het einde of het midden van de tekenreekstekst in de PathToMatch eigenschap wordt weergegeven. Als u bijvoorbeeld alle paden wilt vinden die beginnen met ~/vdir, wordt de PathToMatch eigenschap ingesteld op '~/vdir%'.

Met behulp van de standaardprovider voor persoonlijke instellingen worden de PersonalizationStateInfo-afgeleide objecten in alfabetische volgorde geretourneerd en gesorteerd op een combinatie van pad en gebruikersnaam in oplopende volgorde. De volgorde van de objecten in de verzameling wordt bepaald door de provider.

De pathToMatch parameter kan zijn null. Als deze optie is ingesteld null, wordt de parameter genegeerd bij het uitvoeren van query's.

De geretourneerde gegevens worden beperkt door pageIndex en pageSize, waarbij bepaalt welke pageIndex records moeten worden geretourneerd en pageSize het aantal records dat moet worden geretourneerd. Als pageIndex de waarde bijvoorbeeld is ingesteld op 0 en pageSize is ingesteld op 25, zijn de geretourneerde gegevens de eerste 25 vermeldingen. Als pageIndex de waarde is ingesteld op 1 en pageSize is ingesteld op 25, worden de geretourneerde gegevens 26 tot 50. De totalRecords parameter retourneert het totale aantal records dat beschikbaar is.

Zie ook

Van toepassing op