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

Примеры

В следующем примере кода показано декларативное AllowLayoutChange использование свойства в элементе WebPartZone управления . Полный пример кода, включая исходный файл кода программной части и 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.

Если AllowLayoutChange для заданной зоны задано значение false , существует ряд действий, которые конечные пользователи не могут выполнять с элементами управления в зоне.

• Пользователи не могут перетаскивать элементы управления в другую зону, изменять порядок элементов управления в пределах зоны или перемещать элементы управления в зону.

• Ряд свойств, влияющих на пользовательский интерфейс WebPart элементов управления в зоне, отключен, поэтому пользователи не могут изменять эти свойства во время редактирования элемента управления с помощью AppearanceEditorPart элементов управления и BehaviorEditorPart .

• Пользователи не могут добавлять новые элементы управления в зону из CatalogPart элемента управления.

• Команды закрытия, удаления, свернуть и восстановить не отображаются в элементах управления в зоне.

AllowLayoutChange Хотя свойство влияет на возможность конечных пользователей изменять макет зоны с помощью пользовательского интерфейса, оно не влияет на возможность программного изменения макета. Например, если AllowLayoutChange для задано значение false, пользователи не могут закрывать элементы управления в зоне, но разработчик может по-прежнему CloseWebPart вызывать метод для программного закрытия элементов управления.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей. Дополнительные сведения см. в разделах ThemeableAttribute и ASP.NET Темы и обложки.

См. также раздел

• AllowZoneChange
• элементы управления веб-частей ASP.NET