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 （或被 包 GenericWebPart 覆，因此 WebPart被視為 的伺服器控制項），在匯入的 XML 描述檔中被引用。
例外狀況
reader 是 null。
reader 無法讀取檔案。
-或-
reader 需要顯示匯入錯誤訊息，但檔案中找不到錯誤訊息。
-或-
reader 當檔案結束時，卻找不到包含匯出資料的 XML 元素。
備註
此 ImportWebPart 方法匯入由該 ExportWebPart 方法為伺服器控制所建立的 XML 描述檔案。 匯入的並非實際的伺服器控制，而是包含控制狀態與屬性資料的描述檔案。 描述檔中所參考的控制項與組合語言必須已在使用者嘗試匯入描述檔的伺服器上取得。
要啟用匯入控制項，開發者需要在啟用匯入的頁面新增 CatalogZone 一個控制項。 在區域內必須新增一個 ImportCatalogPart 控制。 此控制項提供檔案對話框，讓使用者瀏覽並定位以匯入的描述檔案。
當使用者找到描述檔並開始匯入後，該描述檔會被 ImportWebPart 方法讀取。 若無錯誤且找到組件與控制，伺服器控制項會加入控制項內 ImportCatalogPart 的目錄，並將描述檔案中指定的各種屬性與狀態資料套用到控制項。 使用者可以選擇控制項並將其加入頁面。
Important
與此 ExportWebPart 方法相同，該 ImportWebPart 方法也存在一定的安全風險。 由於這涉及將資料匯入網站，惡意使用者可能會嘗試在被匯入的描述檔案中插入錯誤資料甚至腳本程式碼。 那麼壞資料可能會出現在頁面上、資料庫中，或是插入的腳本執行。 關於匯入描述檔案可能存在的風險及避免這些風險的方法，請參閱 「保護網頁」。
