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] 它。 您也可以將屬性 true 的 [Personalizable] 參數設定 isSensitive 為 ，選擇性地將可匯出屬性標示為包含敏感性資料。 根據預設， isSensitive 是 false 。 開發人員可以將 參數設定為 true ，以指出資料是機密的。

若要啟用 webPart 匯出，開發人員會將其 ExportMode 屬性值設定為 All (，其中包含所有個人化和敏感性屬性) ，或設定為 NonSensitiveData ，這會匯出機密屬性以外的所有專案。

重要

允許使用者從控制項匯出資料，以及將資料匯入其他控制項，需要一些安全性風險。 開發人員應該使用上述方法來保護敏感性資料，如果開發人員想要避免完全公開資料的風險，他們完全不應該啟用匯出 webPart 功能。 如需網頁元件安全性問題的詳細資訊，請參閱 保護網頁元件頁面。

另請參閱

• ExportMode
• ImportWebPart(XmlReader, String)
• 保護網頁元件頁面