WebPartManager.ImportWebPart(XmlReader, String) Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls.WebParts
Ensamblado:
System.Web.dll

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.WebPart
Public Overridable Function ImportWebPart (reader As XmlReader, ByRef errorMessage As String) As WebPart

Pará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

WebPart

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

ArgumentNullException

reader es null.

EndOfStreamException

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.

Se aplica a

Consulte también