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

如果您在瀏覽器中載入網頁，則會正常轉譯每個控制項的內容。 您可以在 [顯示模式] 下拉式清單控制項中選取 [設計]，將頁面切換為設計模式。 如果您將其中一個控制項拖曳到標示為 WebPartZone2的空白區域，其內容會以不同的方式轉譯，因為自訂 WebPartChrome 物件不會用於轉譯。 如果您嘗試將自訂 WebPartChrome 類別與 類別以外的 MyZone 任何其他區域搭配使用，因為上述原始程式碼，這是相同的效果。

備註

屬性 Zone 會提供區域參考， WebPartZoneBase 其中包含物件提供轉譯的 WebPartChrome 控制項。

適用於

另請參閱