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 オブジェクトでラップされています。 CopyWebPart メソッドは、GenericWebPart コントロールを検出すると、GenericWebPart コントロールの新しいインスタンスを返し、その中に子コントロールの新しいインスタンスがラップされます。

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

注意 (継承者)

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

こちらもご覧ください

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