WebPartManager.ImportWebPart(XmlReader, String) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
导入包含控件的状态和属性数据的 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.WebPartPublic Overridable Function ImportWebPart (reader As XmlReader, ByRef errorMessage As String) As WebPart参数
返回
在 WebPart 导入的 XML 说明文件中引用的（或由一个 GenericWebPart 并因此被视为 WebPart）包装的服务器控件。
例外
reader 是 null。
reader 无法读取文件。
-或-
reader 需要显示导入错误消息，但没有在文件中找到一个。
-或-
reader 到达文件的末尾，但没有找到包含导出数据的 XML 元素。
注解
该方法 ImportWebPart 导入由 ExportWebPart 服务器控件的方法创建的 XML 说明文件。 它不是导入的实际服务器控件，而是仅包含有关控件的状态和属性数据的说明文件。 说明文件中引用的控件和程序集必须已在用户尝试导入说明文件的服务器上可用。
若要启用导入控件，开发人员需要在启用导入的页面上添加控件 CatalogZone 。 在区域中，必须添加控件 ImportCatalogPart 。 此控件提供一个文件对话框，允许用户浏览和查找要导入的说明文件。
用户找到说明文件并开始导入后，方法将读取 ImportWebPart 说明文件。 如果没有错误，并且找到程序集和控件，服务器控件将添加到控件内的 ImportCatalogPart 目录中，说明文件中指定的各种属性和状态数据将应用于控件。 然后，用户可以选择控件并将其添加到页面。
Important
与该方法 ExportWebPart 一样，该方法 ImportWebPart 具有一些安全风险的可能性。 由于它涉及到将数据导入网站，恶意用户可能会尝试将不良数据甚至脚本代码插入导入的说明文件中。 然后，错误的数据可能会显示在页面上，或者出现在数据库中，或者插入的脚本可以运行。 有关与导入说明文件相关的潜在风险以及避免这些风险的方法的概述，请参阅 “保护 Web 部件页”。
