WebPartZoneCollection コンストラクター

定義

名前空間:

System.Web.UI.WebControls.WebParts

アセンブリ:

System.Web.dll

WebPartZoneCollection クラスの新しいインスタンスを初期化します。

オーバーロード

WebPartZoneCollection()	WebPartZoneCollection クラスの空のインスタンスを初期化します。
WebPartZoneCollection(ICollection)	WebPartZoneCollection クラスのインスタンスを、WebPartZone オブジェクトのコレクションを渡すことによって初期化します。

注釈

コンストラクターは WebPartZoneCollection 、コントロール、Web パーツ コントロール セット内の他のコントロール、またはカスタム開発者コードによって使用 WebPartManager され、Web パーツ ページに存在するコントロールの WebPartZone 読み取り専用コレクションを作成します。

WebPartZoneCollection()

WebPartZoneCollection クラスの空のインスタンスを初期化します。

public:
 WebPartZoneCollection();

public WebPartZoneCollection ();

Public Sub New ()

注釈

コントロールは WebPartManager 、独自のコンストラクター内でこのコンストラクターを使用して、Web パーツ ページの クラスの WebPartZoneCollection 新しいインスタンスを初期化します。

こちらもご覧ください

• ASP.NET Web パーツ コントロール

WebPartZoneCollection(ICollection)

WebPartZoneCollection クラスのインスタンスを、WebPartZone オブジェクトのコレクションを渡すことによって初期化します。

public:
 WebPartZoneCollection(System::Collections::ICollection ^ webPartZones);

public WebPartZoneCollection (System.Collections.ICollection webPartZones);

new System.Web.UI.WebControls.WebParts.WebPartZoneCollection : System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.WebPartZoneCollection

Public Sub New (webPartZones As ICollection)

パラメーター

webPartZones

ICollection

ICollection オブジェクトの WebPartZone。

例外

ArgumentNullException

ゾーンのコレクションは null です。

ArgumentException

コレクション内のオブジェクトの １ つが null か、WebPartZone 型ではありません。

例

次のコード例では、 コンストラクターの使用方法を WebPartZoneCollection 示します。 この例の完全なコードは、クラスの概要の「例」セクションにあります WebPartZoneCollection 。

コードの次のセクションでは、 プロパティの値を WebPartZoneCollection 取得してオブジェクトを変数に割り当てることに Zones 注意してください。 必要に応じて、 プロパティから Zones すべてのゾーンを割り当てるのではなく、ページ上のすべてのゾーンのサブセットを含むオブジェクトの WebPartZoneBase 配列を作成し、その配列を新 WebPartZoneCollection しいオブジェクトに割り当てることができます。

protected void Button5_Click(object sender, EventArgs e)
{
  Label1.Text = String.Empty;

  WebPartZoneCollection zoneCollection = mgr.Zones;
  foreach (WebPartZone zone in zoneCollection)
  {

    if (zone.WebPartVerbRenderMode == WebPartVerbRenderMode.Menu)
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar;
    else
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu;
  }
}

Protected Sub Button5_Click(ByVal sender As Object, ByVal e As EventArgs)
  Label1.Text = String.Empty

  Dim zoneCollection As WebPartZoneCollection = mgr.Zones
  Dim zone As WebPartZone
  For Each zone In zoneCollection
    If zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu Then
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar
    Else
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu
    End If
  Next zone

End Sub

コレクションが作成されたら、コレクションを簡単に反復処理し、含まれるすべてのゾーンまたはその内容に対して操作を実行できます。 サンプル コードを実行するには、ブラウザーでページを読み込み、各ゾーンの [動詞レンダリング モードの切り替え ] ボタンをクリックします。 これは、ゾーンに含まれる各サーバー コントロールのタイトル バーの動詞をレンダリングする方法を代替します。 動詞はドロップダウン メニューに表示することも、タイトル バーのリンクとして直接表示することもできます。

注釈

オブジェクトの WebPartZoneCollection カスタム コレクション WebPartZone を作成して、オブジェクトに対するプログラム操作を実行する場合は、 コンストラクターを使用します。 たとえば、 プロパティに Zones アクセスし、Web パーツ ページでオブジェクトの WebPartZone サブセットを作成し、オブジェクトに WebPartZoneCollection 割り当ててから、そのゾーンのサブセットのみの子コントロールまたはさまざまなプロパティに対して操作を実行できます。

こちらもご覧ください

• ASP.NET Web パーツ コントロール