WebPartChrome.Zone プロパティ

定義

名前空間:

System.Web.UI.WebControls.WebParts

アセンブリ:

System.Web.dll

関連付けられた WebPartZoneBase ゾーンへの参照を取得します。

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

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 オブジェクトがレンダリングに使用されていないため、その内容は異なる方法でレンダリングされます。 これは、上記のソース コードのために、 クラス以外MyZoneの他のゾーンでカスタム WebPartChrome クラスを使用しようとした場合に実現するのと同じ効果です。

注釈

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

こちらもご覧ください

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