WebPartZoneBase.AllowLayoutChange 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置指示区域中 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
。
- 属性
示例
下面的代码示例演示如何在 控件上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 主题和皮肤。
适用于
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈