ToolZone クラスとは何？わかりやすく解説 Weblio辞書

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

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

ToolZone クラス

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

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

Visual Basic (宣言)

Public MustInherit Class
 ToolZone
    Inherits WebZone
    Implements IPostBackEventHandler

Visual Basic (使用法)

Dim instance As ToolZone

public abstract class ToolZone : WebZone, IPostBackEventHandler

C++

public ref class ToolZone abstract : public
 WebZone, IPostBackEventHandler

public abstract class ToolZone extends WebZone
 implements IPostBackEventHandler

JScript

public abstract class ToolZone extends
 WebZone implements IPostBackEventHandler

解説

Web パーツコントロールセットにおいて、ゾーンとはサーバーコントロールを格納した Web ページ上の領域で、格納しているコントロールに対して一貫性のあるユーザーインターフェイス (UI: User Interface) を備えたモジュールレイアウトを提供します。

基本 WebZone クラスから派生する一般的な 2 種類のゾーンコントロールとして、WebPartZoneBase ゾーンと ToolZone ゾーンが存在します。WebPartZoneBase ゾーンには、サーバーコントロール (カスタム WebPart コントロール、または ASP.NET コントロールやユーザーコントロールなどのその他のサーバーコントロール) が含まれています。これらのコントロールが Web ページの主要な UI を構成し、プログラムやユーザーによって非表示にされる場合を除きすべての表示モードで表示されます。

ToolZone ゾーンは、ページがゾーンに関連付けられた特定の表示モードの場合にだけ表示される特別なヘルパーゾーンで、これらのゾーンには、ユーザーがレイアウト、外観、プロパティ、および Web ページの内容をブラウザから変更できる特別なサーバーコントロールも含まれています。開発者は、基本 ToolZone クラスまたは派生した ToolZone ゾーンから継承してカスタムゾーンを作成できます。

Web パーツコントロールセットには、次の表に記載されている 3 種類の ToolZone ゾーンが含まれます。

ツールゾーンの種類	説明
EditorZone	WebPart を編集するために使用されるコントロールと、ページのサーバーコントロールのプロパティを格納しています。
CatalogZone	CatalogPart コントロールを格納しています。このコントロールには、ユーザーがページに追加できる WebPart コントロールが含まれています。
ConnectionsZone	宣言型マークアップ要素は含まれません。このゾーンは独立しています。ユーザーが WebPart コントロール間の接続を管理するための特別な UI を実行時に表示します。

ToolZone 基本クラスには、派生ゾーンで役立つさまざまなメソッドおよびプロパティが用意されています。これには、WebZone クラスの基本メソッドをオーバーライドしてゾーンのヘッダーおよびフッターのボタンと他の UI 属性を表示する RenderHeader メソッドおよび RenderFooter メソッドが含まれます。また、動詞の処理のためのさまざまなメンバも存在します。動詞は、ユーザーが各種のゾーンで実行できる共通の UI 操作です。動詞の処理に関係するメンバには、RenderVerb、RenderVerbs、および HeaderCloseVerb が含まれます。

ToolZone には、WebPartDisplayMode オブジェクトを AssociatedDisplayModes コレクションに追加する 2 つのオーバーロードされたメソッドが含まれています。この表示モードに関連付けられたコレクションにより、特定のゾーンの種類に関連する表示モード、つまり、ゾーンが表示される表示モードが決まります。特定の Web ページのすべての ToolZone ゾーンに関連付けられたすべての表示モードの結合結果により、(通常のブラウズモードは除き) ページで使用できる表示モードまたはサポートされる表示モードが決まります。特定のページでサポートされる表示モードのコレクションは、SupportedDisplayModes プロパティに含まれています。

メモ
特定の時点で、あるページに対してアクティブにできる表示モードは 1 つだけです。現在アクティブな表示モードは DisplayMode プロパティで参照されます。

ToolZone クラスにも、ゾーンのさまざまな UI 要素のスタイル属性を含む、多数のスタイルプロパティが含まれています。ToolZone スタイルプロパティの一例として、EditUIStyle、HeaderVerbStyle、InstructionTextStyle、および LabelStyle が挙げられます。

継承時の注意 Web パーツコントロールセットには、上記の「解説」で列挙される特殊なゾーンが含まれ、通常それらの 1 つから派生させてカスタムの動作をゾーンに追加できます。ただし、ゾーンの表示をプログラムを使用してより高度に制御するには、ToolZone クラスから直接継承する必要があります。たとえば、検索ゾーンなど、特殊なタスク用のカスタムゾーンを作成する必要のある場合があります。カスタムゾーンを作成するには、すべての仮想 ToolZone メンバをオーバーライドして表示を完全にカスタマイズするか、または特定のメンバだけをオーバーライドできます。必要に応じて、WebPartDisplayMode クラスから継承してゾーンのカスタムの表示モードを作成することもできますが、これは必須ではありません。ゾーンのコンストラクタで、ゾーンの表示対象となるさまざまな表示モードを WebPartDisplayModeCollection オブジェクトに追加する必要があります。その結果、ページがそれらの表示モードの場合にそのゾーンが表示されるようになります。

.NET Framework のセキュリティ

AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.CompositeControl
         System.Web.UI.WebControls.WebParts.WebZone
          System.Web.UI.WebControls.WebParts.ToolZone
             System.Web.UI.WebControls.WebParts.CatalogZoneBase
             System.Web.UI.WebControls.WebParts.ConnectionsZone
             System.Web.UI.WebControls.WebParts.EditorZoneBase

スレッドセーフ

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