WebPartManager.ExportWebPart(WebPart, XmlWriter) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea un archivo de descripción XML que contiene los datos de estado y de propiedades correspondientes a un control de servidor.
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)Parámetros
- webPart
- WebPart
Control del que se exportarán los datos.
- writer
- XmlWriter
Objeto XmlWriter que escribe los datos exportados de webPart en un archivo de descripción XML.
Excepciones
webPart no está incluido en la colección de controles a la que se hace referencia en Controls.
o bien
La propiedad ExportMode de webPart está establecida en un valor de None, que significa que la exportación está deshabilitada para webPart.
Comentarios
El ExportWebPart método ensambla varios datos de estado y propiedad de webPart en un archivo XML. Los datos incluyen información sobre el propio control, incluidos su ensamblado, datos de estado y datos de propiedad. El usuario que inicia la exportación puede guardar el archivo XML en el disco en el equipo local o en la red. A continuación, otros usuarios pueden importar el archivo de descripción a otra página o sitio web, y aplicar los datos de estado y propiedad a una instancia diferente de webPart. Esto proporciona un mecanismo rápido y práctico para que los usuarios compartan y reutilicen su configuración en los controles de servidor, y también proporciona a los desarrolladores un medio para controlar la apariencia y el comportamiento de los controles exportados e importados.
Las propiedades de webPart no se exportan de forma predeterminada. Para habilitar la exportación de una propiedad, debe marcarla con el [Personalizable] atributo en el código fuente. También puede marcar opcionalmente una propiedad exportable como que contiene datos confidenciales estableciendo el isSensitive parámetro del [Personalizable] atributo en true. De forma predeterminada, isSensitive es false. Los desarrolladores pueden establecer el parámetro en true para indicar que los datos son confidenciales.
Para permitir webPart la exportación, un desarrollador establece su ExportMode valor All de propiedad en (que incluye todas las propiedades personalizables y confidenciales), o a NonSensitiveData, que exporta todo excepto las propiedades confidenciales.
Importante
Permitir a los usuarios exportar datos de controles e importar datos a otros controles conlleva algunos riesgos de seguridad. Los desarrolladores deben usar el enfoque descrito anteriormente para proteger los datos confidenciales y, si quieren evitar el riesgo de exponer datos por completo, no deben habilitar la webPart exportación en absoluto. Para obtener más información sobre elementos web problemas de seguridad, consulte Protección de elementos web Pages.