WebPartManager.ExportWebPart(WebPart, XmlWriter) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

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 -> unit

Public 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

ArgumentNullException

webPart è null.

-oppure- writer è null.

ArgumentException

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.

Si applica a