WebPartManager.ExportWebPart(WebPart, XmlWriter) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitPublic 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
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.
