WebPartManager.ExportWebPart(WebPart, XmlWriter) Metoda

Reference

Definice

Obor názvů:: System.Web.UI.WebControls.WebParts

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vytvoří soubor popisu XML, který obsahuje data stavu a vlastností pro ovládací prvek serveru.

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 -> unit

Public Overridable Sub ExportWebPart (webPart As WebPart, writer As XmlWriter)

Parametry

webPart: WebPart

Ovládací prvek, ze kterého budou data exportována.

writer: XmlWriter

Exportovaná XmlWriter data zapisuje do webPart souboru popisu XML.

Výjimky

ArgumentNullException

webPart je null.

-nebo- writer je null.

ArgumentException

webPart není obsažena v kolekci ovládacích prvků, na které Controlsodkazuje .

-nebo- Vlastnost ExportMode webPart je nastavena na hodnotu None, což znamená, že export je zakázán pro webPart.

Poznámky

Metoda ExportWebPart sestaví různá data o stavu a vlastnosti z webPart souboru XML. Data obsahují informace o samotném ovládacím prvku, včetně jeho sestavení, stavových dat a dat vlastností. Uživatel, který zahájí export, může soubor XML uložit na disk v místním počítači nebo v síti. Ostatní uživatelé pak mohou importovat soubor popisu na jinou stránku nebo web a použít data o stavu a vlastnosti na jinou instanci webPart. To poskytuje uživatelům rychlý a pohodlný mechanismus pro sdílení a opakované použití nastavení na ovládacích prvcích serveru a také poskytuje vývojářům prostředky k řízení vzhledu a chování exportovaných a importovaných ovládacích prvků.

webPart Vlastnosti se ve výchozím nastavení neexportují. Pokud chcete povolit export vlastnosti, musíte ji označit atributem [Personalizable] ve zdrojovém kódu. Volitelně můžete také označit exportovatelnou vlastnost jako obsahující citlivá data nastavením isSensitive parametru atributu [Personalizable] na true. Ve výchozím nastavení isSensitive je false. Vývojáři můžou parametr nastavit tak, aby true indikovat, že data jsou citlivá.

Aby bylo možné webPart exportovat, vývojář nastaví jeho ExportMode hodnotu vlastnosti na All buď (včetně všech osobních a citlivých vlastností), nebo na NonSensitiveData, které exportuje vše kromě citlivých vlastností.

Důležité

Povolení uživatelům exportovat data z ovládacích prvků a import dat do jiných ovládacích prvků zahrnuje určitá bezpečnostní rizika. Vývojáři by měli použít výše uvedený přístup k ochraně citlivých dat a pokud se chtějí vyhnout riziku úplného vystavení dat, neměli by povolit export webPart vůbec. Podrobnosti o problémech se zabezpečením Webové části najdete v tématu Zabezpečení Webové části stránek.

Platí pro

Sdílet prostřednictvím