PersonalizationProvider.DetermineInitialScope Methode

Definitie

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

Bepaalt of het initialisatiebereik moet zijn Shared of User het bereik.

public:
 virtual System::Web::UI::WebControls::WebParts::PersonalizationScope DetermineInitialScope(System::Web::UI::WebControls::WebParts::WebPartManager ^ webPartManager, System::Web::UI::WebControls::WebParts::PersonalizationState ^ loadedState);
public virtual System.Web.UI.WebControls.WebParts.PersonalizationScope DetermineInitialScope(System.Web.UI.WebControls.WebParts.WebPartManager webPartManager, System.Web.UI.WebControls.WebParts.PersonalizationState loadedState);
abstract member DetermineInitialScope : System.Web.UI.WebControls.WebParts.WebPartManager * System.Web.UI.WebControls.WebParts.PersonalizationState -> System.Web.UI.WebControls.WebParts.PersonalizationScope
override this.DetermineInitialScope : System.Web.UI.WebControls.WebParts.WebPartManager * System.Web.UI.WebControls.WebParts.PersonalizationState -> System.Web.UI.WebControls.WebParts.PersonalizationScope
Public Overridable Function DetermineInitialScope (webPartManager As WebPartManager, loadedState As PersonalizationState) As PersonalizationScope

Parameters

webPartManager
WebPartManager

Hiermee WebPartManager beheert u de persoonlijke gegevens.

loadedState
PersonalizationState

De persoonlijke statusgegevens.

Retouren

PersonalizationScope

Een PersonalizationScope die aangeeft of het huidige personalisatiebereik is User of Shared.

Uitzonderingen

ArgumentNullException

webPartManager is null.

ArgumentException

De pagina die is gekoppeld aan webPartManager is null.

Opmerkingen

Deze methode bepaalt of het huidige bereik moet zijn Shared of User, gezien een verwijzing naar een WebPartManager besturingselement en de persoonlijke statusinformatie die al eerder in de levenscyclus van de persoonlijke instellingen is geladen. Deze informatie wordt gebruikt door een WebPartPersonalization exemplaar voor volgende persoonlijke taken.

De volgende regels worden gebruikt om het persoonlijke bereik te bepalen:

  • In eerste instantie Userwordt ervan uitgegaan dat het bereik .

  • Als het momenteel uitgevoerde gebruikersaccount niet is geverifieerd, wordt het bereik ingesteld op Shared.

  • Als het momenteel uitgevoerde gebruikersaccount wordt geverifieerd, vindt aanvullende verwerking plaats in volgorde van prioriteit:

    • Als de pagina zich in de postbackmodus bevindt, bevat de paginaaanvraag bereikgegevens van een eerdere weergave van de pagina. Als die bereikgegevens aangeeft dat het Shared bereik is gebruikt, wordt het bereik geëvalueerd.Shared

    • Als op de momenteel uitgevoerde pagina controle is overgedragen vanaf een andere pagina (bijvoorbeeld als de overdracht van het besturingselement is opgetreden door het aanroepen van de Transfer methode; houd er rekening mee dat deze specifieke controle niet plaatsvindt voor het plaatsen van meerdere pagina's) en als de eerder uitgevoerde pagina een WebPartManager exemplaar had, wordt het bereik ingesteld op de waarde van de Personalization.Scope eigenschap uit het vorige WebPartManager exemplaar.

    • Als niet aan de vorige criteria wordt voldaan, evalueert het bereik de waarde van de InitialScope eigenschap voor het huidige WebPartManager besturingselement.

Nadat de vorige evaluaties zijn uitgevoerd en als het bereik wordt geëvalueerd Shared , vindt de volgende verwerking plaats:

  • Als het momenteel uitgevoerde gebruikersaccount de EnterSharedScopeUserCapability mogelijkheid heeft, blijft het bereik ingesteld op Shared.

  • Als het momenteel uitgevoerde gebruikersaccount niet over de EnterSharedScopeUserCapability mogelijkheid beschikt, wordt het bereik opnieuw ingesteld op User.

  • Als het resultaat van alle vorige scope-evaluaties is, wordt Shareddit resultaat opgeslagen als een verborgen veld op de momenteel uitgevoerde pagina. Dit is het mechanisme waarbij een pagina de scope-evaluatie opnieuw kan afspelen tijdens volgende postbacks.

Van toepassing op