WebPartManager.CopyWebPart(WebPart) メソッド

protected:
 virtual System::Web::UI::WebControls::WebParts::WebPart ^ CopyWebPart(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);

protected virtual System.Web.UI.WebControls.WebParts.WebPart CopyWebPart (System.Web.UI.WebControls.WebParts.WebPart webPart);

abstract member CopyWebPart : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPart
override this.CopyWebPart : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPart

Protected Overridable Function CopyWebPart (webPart As WebPart) As WebPart

パラメーター

戻り値

ページに追加される WebPart。

注釈

コードからメソッドを CopyWebPart 直接呼び出すことはできません。 このメソッドは、新しい動的WebPartコントロールまたはサーバー コントロールをWebPartManagerページに追加するプロセスの一環として、コントロールによって内部的に呼び出されます。 動的コントロールは、プログラムによって、または Web パーツ ユーザー インターフェイス (UI) を介してページに追加されます。たとえば、ユーザーは、ページのマークアップで直接宣言される静的コントロールとは対照的に、コントロールのカタログからコントロールを追加します。

新しい動的コントロールが追加されると、それがコントロールの WebPart 場合、 CopyWebPart メソッドはコントロールの新しいインスタンスを返します。 追加するコントロールが他の種類のサーバー コントロール (ユーザー コントロール、カスタム コントロール、ASP.NET コントロールなど) である場合、コントロールは Web パーツ コントロール セットによってオブジェクトで GenericWebPart 既にラップされています。 メソッドがコントロールをCopyWebPartGenericWebPart検出すると、コントロールの新しいインスタンスがGenericWebPart返され、その中にラップされた子コントロールの新しいインスタンスが返されます。

メソッドが CopyWebPart 返すコントロールの新しいコピーを作成すると、すべてのプロパティの値も既定値にリセットされます。 カスタマイズ可能なプロパティの値を保持し、新しいコントロール インスタンスにコピーする場合は、 メソッドも呼び出 CopyPersonalizationState す必要があることに注意してください。 メソッドによって実行される最後の CopyWebPart 手順は、 メソッドを CreateDynamicWebPartID 呼び出してコントロールの新しい ID を取得することです。

注意 (継承者)

メソッドは として virtual 宣言されているため、開発者は クラスから WebPartManager 継承し、メソッドをオーバーライドし、コントロールのコピーを作成できる追加のシナリオを提供できます。 たとえば、 メソッドは必要に応じて、XML ファイルにシリアル化されたコントロールを入力として受け取ることができます。 メソッドは XML を逆シリアル化し (存在する場合)、基本メソッドを呼び出して既存のケースを処理し、コントロールの新しいインスタンスを WebPart 返す可能性があります。

適用対象

こちらもご覧ください

• AddWebPart(WebPart, WebPartZoneBase, Int32)
• ASP.NET Web パーツ コントロール