WebPartManager.ImportWebPart(XmlReader, String) 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í.
Importa un archivo de descripción XML que contiene datos de estado y propiedad para un WebPart control y aplica los datos al control.
public:
virtual System::Web::UI::WebControls::WebParts::WebPart ^ ImportWebPart(System::Xml::XmlReader ^ reader, [Runtime::InteropServices::Out] System::String ^ % errorMessage);public virtual System.Web.UI.WebControls.WebParts.WebPart ImportWebPart(System.Xml.XmlReader reader, out string errorMessage);abstract member ImportWebPart : System.Xml.XmlReader * string -> System.Web.UI.WebControls.WebParts.WebPart
override this.ImportWebPart : System.Xml.XmlReader * string -> System.Web.UI.WebControls.WebParts.WebPartPublic Overridable Function ImportWebPart (reader As XmlReader, ByRef errorMessage As String) As WebPartParámetros
- reader
- XmlReader
que XmlReader lee los datos de estado y propiedad del archivo de descripción XML que se está importando.
Devoluciones
Un WebPart control (o un control de servidor que está encapsulado por GenericWebPart y, por tanto, se trata como un WebPart) al que se hace referencia en el archivo de descripción XML importado.
Excepciones
reader es null.
reader no pudo leer el archivo.
O bien
reader necesario para mostrar un mensaje de error de importación, pero no encontró uno en el archivo.
O bien
reader alcanzó el final del archivo sin encontrar el elemento XML que contiene los datos exportados.
Comentarios
El ImportWebPart método importa un archivo de descripción XML creado por el ExportWebPart método para un control de servidor. No es el control de servidor real que se importa, sino solo el archivo de descripción que contiene datos de estado y propiedad sobre el control. El control y el ensamblado a los que se hace referencia en el archivo de descripción ya deben estar disponibles en el servidor donde un usuario intenta importar el archivo de descripción.
Para habilitar la importación de un control, un desarrollador debe agregar un CatalogZone control en la página donde se habilitará la importación. Dentro de la zona, se debe agregar un ImportCatalogPart control. Este control proporciona un cuadro de diálogo de archivo que permite a los usuarios examinar y buscar el archivo de descripción que se va a importar.
Una vez que un usuario encuentra un archivo de descripción y comienza la importación, el método lee el archivo de ImportWebPart descripción. Si no hay errores y si se encuentra el ensamblado y el control, el control de servidor se agrega al catálogo dentro del ImportCatalogPart control y los distintos datos de propiedad y estado especificados en el archivo de descripción se aplican al control. Después, el usuario puede seleccionar el control y agregarlo a la página.
Importante
Al igual que el ExportWebPart método , el ImportWebPart método tiene algunas posibilidades de riesgos de seguridad. Dado que implica importar datos en un sitio web, un usuario malintencionado podría intentar insertar datos incorrectos o incluso código de script en el archivo de descripción que se importa. A continuación, los datos incorrectos podrían aparecer en una página o en una base de datos, o bien se podría ejecutar el script insertado. Para obtener información general sobre los posibles riesgos asociados con la importación de archivos de descripción y formas de evitar esos riesgos, consulte Protección de páginas de elementos web.
