WebPartChrome.Zone プロパティ

protected:
 property System::Web::UI::WebControls::WebParts::WebPartZoneBase ^ Zone { System::Web::UI::WebControls::WebParts::WebPartZoneBase ^ get(); };

protected System.Web.UI.WebControls.WebParts.WebPartZoneBase Zone { get; }

member this.Zone : System.Web.UI.WebControls.WebParts.WebPartZoneBase

Protected ReadOnly Property Zone As WebPartZoneBase

プロパティ値

WebPartZoneBaseに関連付けられているWebPartChromeへの参照。

例

このコード例では、 Zone プロパティの使用方法を示します。 この例を実行するために必要な完全なコードについては、「 WebPartChrome クラスの概要」トピックの「例」セクションを参照してください。

次のコード例では、 Zone プロパティを使用して、 WebPartChrome オブジェクトに現在関連付けられているゾーンが MyZoneの種類のゾーンであるかどうかを判断します。 その場合、コントロールの内容がレンダリングされます。 このコードにより、カスタム WebPartChrome オブジェクトが、そのインスタンスを作成するように設計されたゾーン以外のゾーンと連携できなくなります。

protected override void RenderPartContents(HtmlTextWriter writer, 
  WebPart part)
{

    if (part == this.WebPartManager.SelectedWebPart)
      HttpContext.Current.Response.Write("<span>Not rendered</span>");
    else
      if(this.Zone.GetType() == typeof(MyZone))
        part.RenderControl(writer);
}

Protected Overrides Sub RenderPartContents _
  (ByVal writer As HtmlTextWriter, ByVal part As WebPart)

  If part Is Me.WebPartManager.SelectedWebPart Then
    HttpContext.Current.Response.Write("<span>Not rendered</span>")
  Else
    If (Me.Zone.GetType() Is GetType(MyZone)) Then
      part.RenderControl(writer)
    End If
  End If

End Sub

ブラウザーで Web ページを読み込む場合、各コントロールのコンテンツは通常どおりにレンダリングされます。 [表示モード] ドロップダウン リスト コントロールで [デザイン] を選択すると、ページを デザインモード に切り替えることができます。 コントロールの 1 つを WebPartZone2 というラベルの付いた空の領域にドラッグすると、カスタム WebPartChrome オブジェクトがレンダリングに使用されていないため、その内容は異なる方法でレンダリングされます。 これは、上記のソース コードのために、WebPartChrome クラス以外のゾーンでカスタム MyZone クラスを使用しようとした場合と同じ効果です。

注釈

Zone プロパティは、WebPartZoneBase オブジェクトがレンダリングを提供するコントロールを含むWebPartChrome ゾーンへの参照を提供します。

こちらもご覧ください

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