WebPartZoneCollection コンストラクター

定義

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

オーバーロード

WebPartZoneCollection()

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

WebPartZoneCollection(ICollection)

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

注釈

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

WebPartZoneCollection()

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

public:
 WebPartZoneCollection();
public WebPartZoneCollection ();
Public Sub New ()

注釈

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

こちらもご覧ください

適用対象

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

例外

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

コレクション内のオブジェクトの 1 つが 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 割り当ててから、そのゾーンのサブセットのみの子コントロールまたはさまざまなプロパティに対して操作を実行できます。

こちらもご覧ください

適用対象