WebPartManager.ExportWebPart(WebPart, XmlWriter) 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.
Crea un file di descrizione XML che contiene i dati di stato e proprietà per un controllo server.
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)Parametri
- webPart
- WebPart
Controllo da cui verranno esportati i dati.
- writer
- XmlWriter
Oggetto XmlWriter che scrive i dati esportati da webPart in un file di descrizione XML.
Eccezioni
webPart non è contenuto nella raccolta di controlli a cui si fa riferimento in Controls.
oppure
La ExportMode proprietà di webPart è impostata su un valore di None, il che significa che l'esportazione è disabilitata per webPart.
Commenti
Il ExportWebPart metodo assembla vari dati di stato e proprietà da webPart in un file XML. I dati includono informazioni sul controllo stesso, inclusi l'assembly, i dati sullo stato e i dati delle proprietà. L'utente che avvia l'esportazione può salvare il file XML su disco nel computer locale o nella rete. Altri utenti possono quindi importare il file di descrizione in una pagina o in un sito Web diverso e applicare i dati di stato e proprietà a un'istanza diversa di webPart. Questo offre agli utenti un meccanismo rapido e pratico per condividere e riutilizzare le impostazioni nei controlli server e offre agli sviluppatori un mezzo per controllare l'aspetto e il comportamento dei controlli esportati e importati.
Le proprietà in webPart non vengono esportate per impostazione predefinita. Per abilitare l'esportazione di una proprietà, è necessario contrassegnarla con l'attributo [Personalizable] nel codice sorgente. È anche possibile contrassegnare facoltativamente una proprietà esportabile come contenente dati sensibili impostando il isSensitive parametro dell'attributo [Personalizable] su true. Per impostazione predefinita, isSensitive è false. Gli sviluppatori possono impostare il parametro su true per indicare che i dati sono sensibili.
Per consentire webPart l'esportazione, uno sviluppatore imposta il ExportMode valore della proprietà su All (che include tutte le proprietà personalizzabili e sensibili) o su NonSensitiveData, che esporta tutto tranne le proprietà sensibili.
Importante
Consentire agli utenti di esportare i dati dai controlli e di importare dati in altri controlli comporta alcuni rischi per la sicurezza. Gli sviluppatori devono usare l'approccio descritto in precedenza per proteggere i dati sensibili e, se vogliono evitare completamente l'esposizione dei dati, non devono abilitare l'esportazione webPart . Per informazioni dettagliate sui problemi di sicurezza delle web part, vedere Protezione delle pagine web part.
