PersonalizationScope Enum

Definition

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

Anger anpassningsomfånget för ett WebPartManager objekt eller anpassningsomfånget som gäller för en egenskap i en webbdelskontroll.

public enum class PersonalizationScope
public enum PersonalizationScope
type PersonalizationScope = 
Public Enum PersonalizationScope
Arv
Object
ValueType
Enum
PersonalizationScope

Fält

Name Värde Description
User 0

När du refererar till omfånget WebPartManager för kontrollen User innebär omfånget att personanpassningsdata som är användarspecifika samt personanpassningsdata som gäller för alla användare läses in för alla personliga kontroller på en sida. Endast personanpassningsdata som är användarspecifika kan sparas på sidan.
När du refererar till omfånget som är associerat med en webbdelskontrollegenskap anger User omfånget att egenskapen bara kan läsa in och lagra data som gäller för alla användare när den körs på en sida i Shared omfånget. Men när egenskapens kontroll körs på en sida i User omfånget läses egenskapens data per användare och alla användare in och sammanfogas. I det här fallet sparas dock endast data per användare när en sida körs i User omfånget.
Shared 1

När du refererar till kontrollens omfång WebPartManagerShared innebär omfånget att personanpassningsdata gäller för alla användare för alla personliga kontroller på en sida och även är tillgängliga för att sparas på sidan.
När du refererar till omfånget som är associerat med en webbdelskontrollegenskap anger Shared omfånget att egenskapen normalt bara tillåter inläsning eller sparande av data som är associerade med alla användare.

Exempel

I följande exempel visas hur du använder PersonalizationScope uppräkningen:

if (_manager.Personalization.Scope == PersonalizationScope.Shared)
{
    TextBox2.Text = "Shared Scope";
}
else
    TextBox2.Text = "User Scope";

Kommentarer

Anpassningsomfånget är ett nyckelkoncept i anpassning av webbdelar och är nära integrerat med andra inställningar, inklusive omfånget som sidan, via WebPartManager kontrollen, körs i, omfånget som är associerat med varje egenskap på en kontroll och hur kontrollen lades till på sidan. Mer information om anpassningsomfång finns i Översikt över anpassning av webbdelar.

Anpassningsomfång avser hur anpassningsdata gäller för olika uppsättningar användare. Vissa anpassningsdata gäller endast för en specifik användare och kontroll på en sida. Andra anpassningsdata gäller för alla användare som visar en webbplats. Anpassningsomfånget används inom olika anpassningsområden för att ange vilken uppsättning data som ska hämtas och visas.

När en sida körs i Shared anpassningsomfånget anger detta att endast anpassningsdata för en specifik kontroll, som gäller för alla användare som visar kontrollen, ska läsas in. Beroende på användarens rättigheter för närvarande kan dessa allmänt tillämpliga data också ändras och sparas tillbaka till datalagret. När en sida körs i User anpassningsomfånget anger detta att en kontrolls anpassningsdata ska sparas och läsas in baserat på den användare som körs just nu. Vanligtvis innebär det att användarspecifika data kan läsas in och sparas på en kontroll, medan allmänt tillämpliga data (eller delade data) bara kan visas på kontrollen.

En WebPartManager kontroll, som hanterar anpassningens livscykel på hög nivå, körs i något av de två anpassningsomfången.

Gäller för