WebPartManager.ImportWebPart(XmlReader, String) Metodo

Definizione

Spazio dei nomi:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Importa un file di descrizione XML che contiene i dati di stato e di proprietà per un controllo WebPart e applica i dati al controllo.

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

Parametri

reader

XmlReader

Classe XmlReader che legge i dati di stato e di proprietà dal file di descrizione XML importato.

errorMessage

String

Classe String visualizzata dall'utente se si verifica un errore durante l'importazione.

Restituisce

WebPart

Controllo WebPart (o controllo server incluso in una classe GenericWebPart e quindi considerato come un controllo WebPart) a cui fa riferimento il file di descrizione XML importato.

Eccezioni

ArgumentNullException

reader è null.

EndOfStreamException

reader non è in grado di leggere il file.

-oppure-

readerera necessario per visualizzare un messaggio di errore di importazione ma non è stato trovato nel file.

-oppure-

reader ha raggiunto la fine del file senza trovare l'elemento XML che contiene i dati esportati.

Commenti

Il ImportWebPart metodo importa un file di descrizione XML creato dal ExportWebPart metodo per un controllo server. Non è il controllo server effettivo importato, ma solo il file di descrizione contenente i dati di stato e proprietà sul controllo. Il controllo e l'assembly a cui si fa riferimento nel file di descrizione devono essere già disponibili nel server in cui un utente tenta di importare il file di descrizione.

Per abilitare l'importazione di un controllo, uno sviluppatore deve aggiungere un CatalogZone controllo nella pagina in cui verrà abilitata l'importazione. All'interno della zona è necessario aggiungere un ImportCatalogPart controllo. Questo controllo fornisce una finestra di dialogo file che consente agli utenti di esplorare e individuare il file di descrizione da importare.

Dopo che un utente trova un file di descrizione e inizia l'importazione, il file di descrizione viene letto dal ImportWebPart metodo . Se non sono presenti errori e se viene trovato l'assembly e il controllo, il controllo server viene aggiunto al catalogo all'interno del ImportCatalogPart controllo e i vari dati di proprietà e stato specificati nel file di descrizione vengono applicati al controllo. L'utente può quindi selezionare il controllo e aggiungerlo alla pagina.

Importante

Come il metodo, il ExportWebPartImportWebPart metodo ha alcune potenzialità per i rischi di sicurezza. Poiché comporta l'importazione di dati in un sito Web, un utente malintenzionato potrebbe provare a inserire dati non dannosi o anche codice script nel file di descrizione importato. I dati non valido potrebbero quindi essere visualizzati in una pagina o in un database oppure lo script inserito potrebbe essere eseguito. Per una panoramica dei potenziali rischi associati all'importazione dei file di descrizione e ai modi per evitare tali rischi, vedere Protezione delle pagine web part.

Vedi anche

• ImportCatalogPart
• ExportWebPart(WebPart, XmlWriter)
• Protezione delle pagine web part