WebPartChrome.Zone 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
會看到相關 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的 的參考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。