WebPartManager.ImportWebPart(XmlReader, String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.WebPartPublic Overridable Function ImportWebPart (reader As XmlReader, ByRef errorMessage As String) As WebPartParametri
- 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
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
reader è null.
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.
