通过

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

适用于

另请参阅