WebPartZoneBase.AllowLayoutChange 属性

  • 参考

定义

命名空间:
System.Web.UI.WebControls.WebParts
程序集:
System.Web.dll

获取或设置指示区域中 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

属性值

Boolean

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

属性
ThemeableAttribute

示例

下面的代码示例演示如何在 控件上WebPartZone以声明方式使用 AllowLayoutChange 属性。 有关完整的代码示例（包括代码隐藏源文件和包含此代码中的区域的 .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。

当在给定区域上将 false 设置为 时AllowLayoutChange，会阻止最终用户对区域中的控件执行许多操作：

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

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

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

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

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

无法通过主题或样式表主题设置此属性。 有关详细信息，请参阅 ThemeableAttribute 和 ASP.NET 主题和皮肤。

适用于

另请参阅