WebPartManagerInternals クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
WebPartManager コントロールによって使用される別のクラス メソッドに分離され、コントロールを拡張する開発者がオーバーライドできますが、ページ開発者が必要とすることはほとんどありません。
public ref class WebPartManagerInternals sealedpublic sealed class WebPartManagerInternalstype WebPartManagerInternals = classPublic NotInheritable Class WebPartManagerInternals- 継承
-
WebPartManagerInternals
注釈
WebPartManager クラスは、Web パーツ コントロール セットの中で最大のクラスです。 また、Web パーツ コントロールを含むすべての Web ページで使用され、ページ上のすべての Web パーツ コントロールを調整および管理するため、最も重要な Web パーツ クラスの 1 つです。
WebPartManager クラスは頻繁に使用され、非常に多くの公開メソッドが含まれているため、WebPartManager コントロールを拡張するコントロール開発者が主に必要とするメソッドの一部は、WebPartManagerInternals クラスに含まれています。 この WebPartManagerInternals クラスへの使用頻度の低いメソッドの分離により、 WebPartManager クラスの API が簡略化され、分離されたメソッドは IntelliSense の WebPartManager オブジェクトには表示されません。
WebPartManagerInternals クラスを使用する開発者は、WebPartManager コントロールから継承して広範にカスタマイズする必要があるシナリオを持つ可能性があります。 たとえば、Web ポータル アプリケーションや、カスタム表示モード、カスタム ゾーン、カスタム動詞、カスタム WebPart コントロール、および基本 Web パーツ ユーザー インターフェイス (UI) のその他の拡張機能を使用して Web ポータル アプリケーションまたはパッケージ化された Web パーツ コントロールのセットを構築する場合、多くの場合 (すべてではない) WebPartManager メンバーの一部をオーバーライドして拡張する必要があります。 また、 WebPartManagerInternals クラスはシールされているため継承できませんが、カスタム WebPartManager クラスでは、ページ上の Web パーツ コントロールを管理するために、多くの WebPartManagerInternals メソッドを呼び出す必要があります。
Note
WebPartManager クラスと同様に、WebPartManagerInternals クラスには UI がなく、ページに表示されないサーバー コントロールが用意されています。 WebPartManagerとは異なり、WebPartManagerInternals クラスはページのマークアップでは宣言されません。厳密には、バックグラウンド タスクを実行するワーカー オブジェクトです。 これを使用する一般的な方法は、保護されたWebPartManager プロパティを使用してそれを参照し、参照先オブジェクトを使用してInternals メソッドを呼び出すWebPartManagerInternals クラスによって示されます。
WebPartManagerInternals クラスにはメソッドのみが含まれます。プロパティやイベントはありません。 クラス内のすべてのメソッドには、 WebPart コントロールの管理、またはコントロール間の接続が含まれます。
WebPart コントロールを処理するために、WebPartManagerInternalsには、それらを追加する (AddWebPart)、RemoveWebPartを削除する、イベントCallOnDeletingを処理する、ゾーンとの関係に関する詳細を取得または設定する (GetZoneIDやSetZoneIndexなど)、基本的なWebPartコントロールプロパティ (SetIsClosedやSetHasSharedDataなど) を設定するメソッドが含まれています。
接続を処理するために、 WebPartManagerInternals には、接続を削除する (DeleteConnection)、使用するトランスフォーマー オブジェクトの設定 (SetTransformer)、接続が共有されているかどうか、静的かどうか (SetIsShared(WebPartConnection, Boolean) と SetIsStatic(WebPartConnection, Boolean)) の設定、使用する接続エラー メッセージの設定 (SetConnectErrorMessage) が含まれます。