WebPartManager.ExportWebPart(WebPart, XmlWriter) 方法

  • 参考

定义

命名空间:
System.Web.UI.WebControls.WebParts
程序集:
System.Web.dll

创建包含服务器控件的状态和属性数据的 XML 说明文件。

public:
 virtual void ExportWebPart(System::Web::UI::WebControls::WebParts::WebPart ^ webPart, System::Xml::XmlWriter ^ writer);
public virtual void ExportWebPart (System.Web.UI.WebControls.WebParts.WebPart webPart, System.Xml.XmlWriter writer);
abstract member ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unit
override this.ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unit
Public Overridable Sub ExportWebPart (webPart As WebPart, writer As XmlWriter)

参数

webPart
WebPart

将从中导出数据的控件。

writer
XmlWriter

一个 XmlWriter，它将导出的数据从 webPart 写入 XML 说明文件。

例外

ArgumentNullException

webPart 为 null。

- 或 -

writer 为 null。

ArgumentException

webPart 未包含在 Controls 中所引用的控件集合中。

- 或 -

webPart 的 ExportMode 属性设置为值 None，该值表明对 webPart 禁用导出。

注解

方法 ExportWebPart 将 中的 webPart 各种状态和属性数据组合到 XML 文件中。 数据包括有关控件本身的信息，包括其程序集、状态数据和属性数据。 启动导出的用户可将 XML 文件保存到本地计算机或网络上的磁盘。 然后，其他用户可以将说明文件导入到其他页面或网站，并将状态和属性数据应用于 的不同实例 webPart。 这为用户在服务器控件上共享和重复使用其设置提供了一种快速方便的机制，它还为开发人员提供了一种控制导出和导入控件的外观和行为的方法。

默认情况下，不导出 上的 webPart 属性。 若要启用属性的导出，必须在源代码中使用 属性对其进行 [Personalizable] 标记。 还可以选择通过将 属性的 [Personalizable] 参数设置为 isSensitive ，将可导出属性true标记为包含敏感数据。 默认情况下，isSensitive 为 false。 开发人员可以将 参数设置为 true 以指示数据是敏感的。

若要启用 webPart 导出，开发人员将其 ExportMode 属性值设置为 All (（包括) 所有可个性化和敏感属性）或 （ NonSensitiveData导出除敏感属性之外的所有内容）。

重要

允许用户从控件导出数据并将数据导入其他控件会产生一些安全风险。 开发人员应使用上面讨论的方法来保护敏感数据，如果他们希望避免完全公开数据的风险，他们根本不应该启用导出 webPart 。 有关 Web 部件安全问题的详细信息，请参阅 保护 Web 部件页。

适用于

另请参阅