WebPartManager.ImportWebPart(XmlReader, String) 方法

定义

命名空间:

System.Web.UI.WebControls.WebParts

程序集:

System.Web.dll

导入包含 WebPart 控件的状态和属性数据的 XML 说明文件，并将这些数据应用于控件。

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

参数

reader

XmlReader

一个 XmlReader，它从导入的 XML 说明文件中读取状态和属性数据。

errorMessage

String

在导入过程中遇到错误时将向用户显示的 String。

返回

WebPart

在导入的 XML 说明文件中引用的 WebPart（或由 GenericWebPart 包装并因此被视为 WebPart 的服务器控件）。

例外

ArgumentNullException

reader 为 null。

EndOfStreamException

reader 未能读取文件。

- 或 -

需要 reader 来显示导入错误消息，但在文件中未找到。

- 或 -

reader 已到达文件末尾，但未找到包含导出数据的 XML 元素。

注解

方法 ImportWebPart 导入由 ExportWebPart 服务器控件的 方法创建的 XML 说明文件。 导入的不是实际服务器控件，而只是包含有关控件的状态和属性数据的说明文件。 说明文件中引用的控件和程序集必须在用户尝试导入说明文件的服务器上已可用。

若要启用导入控件，开发人员需要在将启用导入的页面上添加控件 CatalogZone 。 在区域中，必须添加控件 ImportCatalogPart 。 此控件提供一个文件对话框，允许用户浏览和查找要导入的说明文件。

用户找到说明文件并开始导入后，说明文件将由 ImportWebPart 方法读取。 如果没有错误并且找到程序集和控件，则服务器控件将添加到控件内的 ImportCatalogPart 目录中，并在说明文件中指定的各种属性和状态数据将应用于控件。 然后，用户可以选择控件并将其添加到页面。

重要

与 方法一 ExportWebPart 样，方法 ImportWebPart 也可能存在一些安全风险。 由于它涉及到将数据导入网站，因此恶意用户可能会尝试在导入的描述文件中插入错误数据，甚至编写脚本代码。 然后，错误数据可能会出现在页面上或数据库中，或者插入的脚本可能会运行。 有关与导入说明文件相关的潜在风险的概述，以及避免这些风险的方法，请参阅 保护 Web 部件页。

另请参阅

• ImportCatalogPart
• ExportWebPart(WebPart, XmlWriter)
• 保护 Web 部件页