WebPartZoneBase.AllowLayoutChange 属性

定义

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

public:
 virtual property bool AllowLayoutChange { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
public virtual bool AllowLayoutChange { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.AllowLayoutChange : bool with get, set
Public Overridable Property AllowLayoutChange As Boolean

属性值

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

属性

示例

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

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

<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>
<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 主题和外观

适用于

另请参阅