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 的区域的引用。