WebPartManagerInternals クラス

.NET Framework クラス ライブラリ リファレンス

WebPartManagerInternals クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

WebPartManager コントロールによって使用され、そのコントロールを拡張する開発者がオーバーライドできる個別のクラスのメソッドに分離します。ページの開発者がこのクラスを必要とすることはほとんどありません。

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

Visual Basic (宣言)

Public NotInheritable Class
 WebPartManagerInternals

Visual Basic (使用法)

Dim instance As WebPartManagerInternals

C#

public sealed class WebPartManagerInternals

C++

public ref class WebPartManagerInternals sealed

J#

public final class WebPartManagerInternals

JScript

public final class WebPartManagerInternals

解説

WebPartManager クラスは、Web パーツ コントロール セットで最も大きなクラスです。また、このクラスは、Web パーツ コントロールが含まれるすべての Web ページで使用され、ページ上のすべての Web パーツ コントロールを適切に管理するため、最も重要な Web パーツ クラスの 1 つでもあります。

WebPartManager クラスは頻繁に使用され、多くの公開メソッドを格納しているため、主に WebPartManager コントロールを拡張する開発者が必要とする一部のメソッドが WebPartManagerInternals クラスに格納されています。あまり使用されないメソッドを WebPartManagerInternals クラスに分離することで WebPartManager クラスの API が簡素化され、分離されたメソッドは、IntelliSense の WebPartManager オブジェクトには表示されなくなります。

WebPartManagerInternals クラスを使用する開発者は、WebPartManager コントロールから継承したコントロールを広範囲にカスタマイズする必要のある場合が多くなります。たとえば、カスタムの表示モード、カスタム ゾーン、カスタム動詞、カスタム WebPart コントロール、またはその他の基本 Web パーツ ユーザー インターフェイス (UI: User Interface) の拡張を使用して、Web ポータル アプリケーションやパッケージ化された Web パーツ コントロール セットを作成するには、多くの場合、一部の WebPartManager メンバをオーバーライドして拡張する必要があります。また、WebPartManagerInternals クラスはシールされているため継承できませんが、作成するカスタム WebPartManager クラスで、ページ上の Web パーツ コントロールを管理するために多数の WebPartManagerInternals メソッドを呼び出すことが必要になる場合もあります。

メモ
WebPartManager クラスと同様に、WebPartManagerInternals クラスは、UI がなく、ページ上に表示されないサーバー コントロールを提供します。WebPartManager とは異なり、WebPartManagerInternals クラスは、ページのマークアップで宣言されることはありません。これは厳密にはバックグラウンド タスクを実行するワーカー オブジェクトです。このクラスの一般的な使用例としては、プロテクト Internals プロパティを使用してこのクラスを参照し、その参照オブジェクトを使用して WebPartManagerInternals メソッドを呼び出す WebPartManager クラスがあります。

WebPartManagerInternals クラスにはメソッドだけが含まれ、プロパティやイベントは存在しません。このクラスのすべてのメソッドでは、WebPart コントロールまたはコントロール間の接続の管理が行われます。

WebPart コントロールの処理のために、WebPartManagerInternals には、それらのコントロールの追加 (AddWebPart)、それらのコントロールの削除 (RemoveWebPart)、イベントの処理 (CallOnDeleting)、それらのコントロールとゾーンとの関係の詳細の取得または設定 (GetZoneID、SetZoneIndex など)、または基本 WebPart コントロールのプロパティの設定 (SetIsClosed、SetHasSharedData など) を行うメソッドが含まれます。

接続の処理のために、WebPartManagerInternals には、接続の削除 (DeleteConnection)、使用するトランスフォーマ オブジェクトの設定 (SetTransformer)、接続が共有されるかどうかの設定と接続が静的かどうかの設定 (SetIsShared(WebPartConnection,Boolean) および SetIsStatic(WebPartConnection,Boolean))、使用する接続エラー メッセージの設定 (SetConnectErrorMessage) を行うメソッドが含まれます。

継承階層

System.Object
  System.Web.UI.WebControls.WebParts.WebPartManagerInternals

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebPartManagerInternals メンバ
System.Web.UI.WebControls.WebParts 名前空間
WebPartManager クラス
その他の技術情報
ASP.NET Web パーツ ページ