WebPartManager.ExportWebPart(WebPart, XmlWriter) Metoda
Definice
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 o stavu a vlastnosti pro serverový ovládací prvek.
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)Parametry
- webPart
- WebPart
Ovládací prvek, ze kterého se budou exportovat data.
Výjimky
webPart není obsažena v kolekci ovládacích prvků, na které odkazuje Controls.
nebo
Vlastnost ExportModewebPart 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 na 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 sdílení a opětovného použití jejich nastavení na serverových ovládacích prvcích a také poskytuje vývojářům způsob, jak řídit vzhled 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í je isSensitivefalse. Vývojáři můžou parametr nastavit tak, aby true označí, že data jsou citlivá.
Aby bylo možné webPart exportovat, vývojář nastaví jeho ExportMode hodnotu vlastnosti na hodnotu ( All která zahrnuje všechny personalizovatelné a citlivé vlastnosti) nebo do 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 zveřejnění dat, neměli by povolit export webPart vůbec. Podrobnosti oproblémechch
