WebPartManager.ImportWebPart(XmlReader, String) 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í.

Importuje soubor popisu XML, který obsahuje data WebPart stavu a vlastností ovládacího prvku, a použije data na ovládací prvek.

public:
 virtual System::Web::UI::WebControls::WebParts::WebPart ^ ImportWebPart(System::Xml::XmlReader ^ reader, [Runtime::InteropServices::Out] System::String ^ % errorMessage);

public virtual System.Web.UI.WebControls.WebParts.WebPart ImportWebPart (System.Xml.XmlReader reader, out string errorMessage);

abstract member ImportWebPart : System.Xml.XmlReader * string -> System.Web.UI.WebControls.WebParts.WebPart
override this.ImportWebPart : System.Xml.XmlReader * string -> System.Web.UI.WebControls.WebParts.WebPart

Public Overridable Function ImportWebPart (reader As XmlReader, ByRef errorMessage As String) As WebPart

Parametry

reader: XmlReader

Objekt XmlReader , který čte data stavu a vlastností ze souboru popisu XML, který se importuje.

errorMessage: String

A String , která se zobrazí uživateli, pokud při importu dojde k chybě.

Návraty

WebPart

A WebPart (nebo serverový ovládací prvek, který je zabalený objektem GenericWebPart a proto se považuje za WebPart), na který se odkazuje v importovaném souboru s popisem XML.

Výjimky

ArgumentNullException

reader je null.

EndOfStreamException

reader Aplikace nemůže přečíst soubor.

-nebo-

reader zobrazila chybovou zprávu o importu, ale v souboru se nenašla.

-nebo-

reader dosáhl konce souboru, aniž by se našel element XML, který obsahuje exportovaná data.

Poznámky

Metoda ImportWebPart naimportuje soubor popisu XML, který byl vytvořen metodou ExportWebPart pro serverový ovládací prvek. Neimportuje se skutečný serverový ovládací prvek, ale pouze soubor s popisem obsahující údaje o stavu a vlastnosti ovládacího prvku. Ovládací prvek a sestavení odkazované v souboru popisu již musí být k dispozici na serveru, kde se uživatel pokusí importovat soubor popisu.

Pokud chcete povolit import ovládacího prvku, musí vývojář přidat CatalogZone ovládací prvek na stránku, kde bude import povolený. V rámci zóny ImportCatalogPart musí být přidán ovládací prvek. Tento ovládací prvek poskytuje dialogové okno se souborem, které uživatelům umožňuje procházet a vyhledávat soubor s popisem, který se má importovat.

Jakmile uživatel najde soubor s popisem a zahájí import, metoda soubor s popisem ImportWebPart přečte. Pokud nedojde k žádným chybám a pokud jsou nalezeny sestavení a ovládací prvek, přidá se ovládací prvek serveru do katalogu v rámci ImportCatalogPart ovládacího prvku a různá data vlastností a stavu zadaná v souboru popisu se použijí na ovládací prvek. Uživatel pak může vybrat ovládací prvek a přidat ho na stránku.

Důležité

Podobně jako metoda ExportWebPart ImportWebPart má i metoda určitý potenciál pro rizika zabezpečení. Protože zahrnuje import dat na web, může se uživatel se zlými úmysly pokusit vložit chybná data nebo dokonce kód skriptu do souboru popisu, který je importován. Pak se chybná data můžou objevit na stránce nebo v databázi, případně se vložený skript může spustit. Přehled potenciálních rizik spojených s importem souborů s popisem a způsoby, jak se těmto rizikům vyhnout, najdete v tématu Zabezpečení stránek webových částí.

Platí pro

Sdílet prostřednictvím