WebPartManager.ImportWebPart(XmlReader, String) メソッド

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

パラメーター

戻り値

インポート元となる XML 記述ファイルで参照される WebPart (または、GenericWebPart でラップされ、WebPart として扱われるサーバー コントロール)。

例外

注釈

メソッドは ImportWebPart 、サーバー コントロールの メソッドによって ExportWebPart 作成された XML 記述ファイルをインポートします。 インポートされるのは実際のサーバー コントロールではなく、コントロールに関する状態とプロパティ データを含む説明ファイルのみです。 説明ファイルで参照されるコントロールとアセンブリは、ユーザーが説明ファイルのインポートを試みるサーバーで既に使用できる必要があります。

コントロールのインポートを有効にするには、インポートが有効になるページにコントロールを追加 CatalogZone する必要があります。 ゾーン内では、コントロールを ImportCatalogPart 追加する必要があります。 このコントロールには、ユーザーがインポートする説明ファイルを参照して検索できるファイル ダイアログ ボックスが用意されています。

ユーザーが説明ファイルを見つけてインポートを開始すると、 メソッドによって ImportWebPart 説明ファイルが読み取られます。 エラーがなく、アセンブリとコントロールが見つかった場合は、サーバー コントロールがコントロール内 ImportCatalogPart のカタログに追加され、説明ファイルで指定されたさまざまなプロパティと状態データがコントロールに適用されます。 その後、ユーザーはコントロールを選択してページに追加できます。

適用対象

こちらもご覧ください

• ImportCatalogPart
• ExportWebPart(WebPart, XmlWriter)
• Web パーツ ページのセキュリティ保護