語言

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 描述檔案的 Oracle。

例外狀況

ArgumentNullException

webPart 是 null。

-或-

writer 是 null。

ArgumentException

webPart 不包含在 中 Controls所參考的控制項集合中。

-或-

ExportMode屬性webPart設定為 None，表示對 webPart的匯出功能被禁用。

備註

此 ExportWebPart 方法將各種狀態與屬性資料 webPart 組合成 XML 檔案。 資料包含控制本身的資訊，包括其組裝、狀態資料及屬性資料。 發起匯出的使用者可以將 XML 檔案儲存到本地電腦的磁碟或網路上。 其他使用者可將描述檔案匯入至不同頁面或網站，並將狀態與屬性資料套用到另一個實例 webPart。 這為使用者提供快速且便利的機制，讓使用者能分享並重複使用伺服器控制項的設定，同時也讓開發者能控制匯出與匯入控制項的外觀與行為。

設定上的 webPart 屬性預設不會匯出。 要啟用匯出屬性，必須在原始碼中標示 [Personalizable] 該屬性。 你也可以選擇性地將可匯出屬性標記為包含敏感資料，方法是將屬性的參數isSensitive設[Personalizable]為 true。 根據預設，isSensitive 是 false。 開發者可以設定參數以 true 表示資料是否敏感。

為了讓導出功能， webPart 開發者會將其屬性值設 ExportMode 為 All （包含所有可個人化且敏感的屬性），或設定為 ， NonSensitiveData匯出除敏感屬性外的所有內容。

Important

允許使用者從控制系統匯出資料，或將資料匯入其他控制系統，會帶來一定的安全風險。 開發者應採用上述方法來保護敏感資料，若想避免資料外洩風險，則不應啟用匯出。webPart 有關 Web Parts 安全議題的詳細資訊，請參見 Sesecureing Web Parts Pages。

適用於

另請參閱