WebPartManager.ExportWebPart(WebPart, XmlWriter) Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Crée un fichier de description XML qui contient les données d'état et de propriété du contrôle serveur.

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)

Paramètres

webPart
WebPart

Contrôle à partir duquel les données seront exportées.

writer
XmlWriter

XmlWriter qui écrit les données exportées de webPart dans un fichier de description XML.

Exceptions

ArgumentNullException

webPart a la valeur null.

-ou-

writer a la valeur null.

ArgumentException

webPart n'est pas contenu dans la collection de contrôles référencée dans Controls.

- ou -

La propriété ExportMode de webPart a la valeur None, ce qui signifie que l'exportation est désactivée pour webPart.

Remarques

La ExportWebPart méthode assemble différentes données d’état et de propriété à partir d’un webPart fichier XML. Les données incluent des informations sur le contrôle lui-même, y compris son assembly, les données d’état et les données de propriété. L’utilisateur qui lance l’exportation peut enregistrer le fichier XML sur le disque sur l’ordinateur local ou le réseau. D’autres utilisateurs peuvent ensuite importer le fichier de description dans une autre page ou un site Web, et appliquer les données d’état et de propriété à une autre instance de webPart. Cela fournit aux utilisateurs un mécanisme rapide et pratique pour partager et réutiliser leurs paramètres sur les contrôles serveur, et fournit également aux développeurs un moyen de contrôler l’apparence et le comportement des contrôles exportés et importés.

Les propriétés sur webPart ne sont pas exportées par défaut. Pour activer l’exportation d’une propriété, vous devez la marquer avec l’attribut [Personalizable] dans le code source. Vous pouvez également marquer éventuellement une propriété exportable comme contenant des données sensibles, en définissant le isSensitive paramètre de l’attribut [Personalizable] sur true. Par défaut, isSensitive est false. Les développeurs peuvent définir le paramètre sur true pour indiquer que les données sont sensibles.

Pour permettre webPart l’exportation, un développeur définit sa ExportMode valeur de propriété sur ( All ce qui inclut toutes les propriétés personnalisables et sensibles), ou sur NonSensitiveData, qui exporte tout à l’exception des propriétés sensibles.

Important

Le fait de permettre aux utilisateurs d’exporter des données à partir de contrôles et d’importer des données dans d’autres contrôles entraîne des risques de sécurité. Les développeurs doivent utiliser l’approche décrite ci-dessus pour protéger les données sensibles, et s’ils veulent éviter le risque d’exposer complètement des données, ils ne doivent pas activer l’exportation du webPart tout. Pour plus d’informations sur les problèmes de sécurité des composants WebPart, consultez Sécurisation des pages de composants WebPart.

S’applique à

Voir aussi