WebPartManager.ExportWebPart(WebPart, XmlWriter) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Skapar en XML-beskrivningsfil som innehåller tillstånds- och egenskapsdata för en serverkontroll.
public:
virtual void ExportWebPart(System::Web::UI::WebControls::WebParts::WebPart ^ webPart, System::Xml::XmlWriter ^ writer);public virtual void ExportWebPart(System.Web.UI.WebControls.WebParts.WebPart webPart, System.Xml.XmlWriter writer);abstract member ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unit
override this.ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unitPublic Overridable Sub ExportWebPart (webPart As WebPart, writer As XmlWriter)Parametrar
- webPart
- WebPart
Kontrollen från vilken data ska exporteras.
- writer
- XmlWriter
En XmlWriter som skriver exporterade data från webPart till en XML-beskrivningsfil.
Undantag
webPart finns inte i den samling kontroller som refereras i Controls.
-eller-
Egenskapen ExportModewebPart för är inställd på värdet None, vilket innebär att exporten är inaktiverad för webPart.
Kommentarer
Metoden ExportWebPart sammanställer olika tillstånds- och egenskapsdata från webPart till en XML-fil. Data innehåller information om själva kontrollen, inklusive dess sammansättning, tillståndsdata och egenskapsdata. Den användare som initierar exporten kan spara XML-filen på disken på den lokala datorn eller nätverket. Andra användare kan sedan importera beskrivningsfilen till en annan sida eller webbplats och tillämpa tillstånds- och egenskapsdata på en annan instans av webPart. Detta ger en snabb och bekväm mekanism för användare att dela och återanvända sina inställningar på serverkontroller, och det ger även utvecklare möjlighet att kontrollera utseendet och beteendet för exporterade och importerade kontroller.
Egenskaper på webPart exporteras inte som standard. Om du vill aktivera export av en egenskap måste du markera den [Personalizable] med attributet i källkoden. Du kan också markera en exporterbar egenskap som innehåller känsliga data genom att ange parametern isSensitive för [Personalizable] attributet till true. Som standard är isSensitivefalse. Utvecklare kan ange parametern till true för att indikera att data är känsliga.
För att kunna webPart exporteras anger en utvecklare sitt ExportMode egenskapsvärde till antingen All (som innehåller alla personliga och känsliga egenskaper) eller till NonSensitiveData, som exporterar allt utom känsliga egenskaper.
Important
Att tillåta användare att exportera data från kontroller och importera data till andra kontroller medför vissa säkerhetsrisker. Utvecklare bör använda den metod som beskrivs ovan för att skydda känsliga data, och om de vill undvika risken för att exponera data helt och hållet bör de inte aktivera export alls webPart . Mer information om säkerhetsproblem med webbdelar finns i Skydda webbsidor.
