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 dello stato e i dati di proprietà relativi a 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
Classe XmlWriter che scrive i dati esportati da webPart in un file di descrizione XML.
Eccezioni
webPart non è contenuto nell'insieme dei controlli a cui fa riferimento Controls.
-oppure-
La proprietà ExportMode di webPart è impostata su un valore None, che indica la disabilitazione dell'esportazione 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, incluso il relativo 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 sito Web diverso e applicare i dati di stato e proprietà a un'istanza diversa di webPart. Ciò offre un meccanismo rapido e pratico per gli utenti di condividere e riutilizzare le proprie impostazioni nei controlli server e fornisce anche 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 per true indicare che i dati sono sensibili.
Per consentire webPart l'esportazione, uno sviluppatore imposta il valore della ExportMode proprietà su All (che include tutte le proprietà personalizzate e sensibili) o a NonSensitiveData, che esporta tutto tranne le proprietà sensibili.
Importante
Consentendo agli utenti di esportare i dati dai controlli e di importare dati in altri controlli, comporta alcuni rischi di sicurezza. Gli sviluppatori devono usare l'approccio descritto in precedenza per proteggere i dati sensibili e, se vogliono evitare il rischio di esporre completamente i dati, non devono abilitare l'esportazione in webPart tutto. Per informazioni dettagliate sui problemi di sicurezza Web part, vedere Protezione delle pagine Web part.