WebPartManager.CopyWebPart メソッドとは何？わかりやすく解説 Weblio辞書

索引トップ用語の索引ランキング

WebPartManager.CopyWebPart メソッド

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Protected Overridable Function
 CopyWebPart ( _
    webPart As WebPart _
) As WebPart

Dim webPart As WebPart
Dim returnValue As WebPart

returnValue = Me.CopyWebPart(webPart)

protected virtual WebPart CopyWebPart (
    WebPart webPart
)

protected:
virtual WebPart^ CopyWebPart (
    WebPart^ webPart
)

protected WebPart CopyWebPart (
    WebPart webPart
)

protected function CopyWebPart (
    webPart : WebPart
) : WebPart

戻り値
ページに追加される WebPart。

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

メモ
開発者がこのメソッドで追加のコントロールのコピー操作を処理できるようにする場合は、派生クラスでこのメソッドをオーバーライドできます。詳細については、「継承時の注意」を参照してください。

CopyWebPart メソッドは、返すコントロールの新しいコピーを作成すると、すべてのプロパティの値も既定値にリセットします。パーソナル化できるプロパティの値を保存し、これらを新しいコントロールインスタンスにコピーする場合は、CopyPersonalizationState メソッドも呼び出す必要があります。CopyWebPart メソッドが実行する最後の手順では、CreateDynamicWebPartID メソッドを呼び出してコントロールの新しい ID を取得します。

メモ
このメソッドは、コピーしたコントロールの新しい ID を取得します。したがって、その元の ID でページに追加されるダイナミックコントロールへの参照を使用しないでください。代わりに、このメソッドで返されるこのコントロールの新しいインスタンスを参照する必要があります。