WebPartManager.ImportWebPart(XmlReader, String) 方法

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

匯入 XML 描述檔，其中包含 WebPart 控制項的狀態和屬性資料，並將此資料套用至控制項。

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 可能會有安全性風險。 由於其牽涉到將資料匯入網站，惡意使用者可能會嘗試將不正確的資料或甚至腳本程式碼插入匯入的描述檔中。 然後，不正確的資料可能會出現在頁面上，或出現在資料庫中，或插入的腳本可以執行。 如需與匯入描述檔案相關聯的潛在風險概觀，以及避免這些風險的方式，請參閱 保護網頁元件頁面。

另請參閱

• ImportCatalogPart
• ExportWebPart(WebPart, XmlWriter)
• 保護網頁元件頁面