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 de propiedades de un control WebPart 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
Objeto XmlReader que lee los datos de estado y de propiedades del archivo de descripción XML que se importa.
- errorMessage
- String
Objeto String que se muestra al usuario si se encuentra un error durante la importación.
Devoluciones
Control WebPart (o un control de servidor ajustado por un control GenericWebPart que, por tanto, se trata como un control 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 necesitó mostrar un mensaje de error de importación pero encontró uno en el archivo.
o bien
reader llegó el fin 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 ImportWebPart archivo de 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 escribir código 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 el script insertado podría ejecutarse. Para obtener información general sobre los posibles riesgos asociados a la importación de archivos de descripción y formas de evitar esos riesgos, consulte Protección de páginas de elementos web.
