使用英语阅读

通过


WebPartZoneBase.AllowLayoutChange 属性

定义

获取或设置指示区域中 WebPart 控件布局的值是否可以更改的值。

C#
[System.Web.UI.Themeable(false)]
public virtual bool AllowLayoutChange { get; set; }

属性值

如果该布局可以更改,则为 true;否则为 false。 默认值为 true

属性

示例

下面的代码示例演示了 对控件的 属性WebPartZoneAllowLayoutChange声明性使用。 有关完整的代码示例(包括代码隐藏源文件和包含此代码中的区域的.aspx页),请参阅 WebPartZoneBase 类概述。

请注意, AllowLayoutChange 属性设置为 true,这是默认值。 如果将值更改为 false,在将页面加载到浏览器并将页面切换到设计显示模式后,将无法将控件拖动到区域中或区域中 WebPartZone2

ASP.NET (C#)
<asp:WebPartZone 
  ID="WebPartZone2"
  Runat="server" 
  DragHighlightColor="#00ff00"
  AllowLayoutChange="true"
  EmptyZoneText="Add WebParts to this empty Zone."
  BorderWidth="2"
  BorderColor="DarkBlue"
  BorderStyle="Dashed" 
  MenuLabelText="Verbs Menu" 
  MenuPopupImageUrl="label.gif" >
  <VerbStyle Font-Italic="true" />
  <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
  <MenuLabelHoverStyle Font-Bold="true" />
  <MenuVerbHoverStyle BackColor="LightGrey" />
  <MenuVerbStyle Font-Italic="true" /> 
  <ZoneTemplate>
    <asp:Label ID="Label1" Runat="server" Title="Date" />
  </ZoneTemplate>
</asp:WebPartZone>

注解

仅当区域处于页面显示模式时,该 AllowLayoutChange 模式中控件的布局可以更改,例如 DesignDisplayMode

当 在给定区域中设置为 falseAllowLayoutChange,会阻止最终用户对区域中的控制执行许多操作:

  • 用户无法将控件拖动到其他区域、重新排列区域中的控件或将控件移动到该区域。

  • 将禁用影响用户界面 (UI) 区域中控件的 WebPart 多个属性,以便在使用 AppearanceEditorPartBehaviorEditorPart 控件编辑控件时,用户无法编辑这些属性。

  • 用户无法从控件向区域添加新控件 CatalogPart

  • 关闭、删除、最小化和还原谓词不会显示在区域中的控件上。

AllowLayoutChange尽管 属性会影响最终用户通过 UI 更改区域布局的能力,但它不会影响以编程方式更改布局的能力。 例如,如果 AllowLayoutChange 设置为 false,则用户无法关闭区域中的控件,但开发人员仍可以调用 CloseWebPart 方法以编程方式关闭控件。

无法通过主题或样式表主题设置此属性。 有关详细信息,请参阅 ThemeableAttributeASP.NET 主题和外观

适用于

产品 版本
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

另请参阅