WebPartZoneBase.AllowLayoutChange Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Ruft einen Wert ab, der angibt, ob das Layout der WebPart-Steuerelemente in einer Zone geändert werden kann, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, wenn das Layout geändert werden kann, andernfalls false. Der Standardwert ist true.

Attribute

ThemeableAttribute

Beispiele

Im folgenden Codebeispiel wird die deklarative Verwendung der AllowLayoutChange Eigenschaft für ein WebPartZone Steuerelement veranschaulicht. Das vollständige Codebeispiel, einschließlich der CodeBehind-Quelldatei und der ASPX-Seite, die die Zone in diesem Code enthält, finden Sie in der WebPartZoneBase Klassenübersicht.

Beachten Sie, dass die AllowLayoutChange -Eigenschaft auf truefestgelegt ist, was der Standard ist. Wenn Sie den Wert in falseändern, nachdem Sie die Seite in einen Browser geladen und die Seite in den Entwurfsanzeigemodus versetzt haben, können Sie steuerelemente nicht innerhalb oder in die WebPartZone2 Zone ziehen.

<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>

Hinweise

Die AllowLayoutChange -Eigenschaft wird nur wirksam, wenn sich eine Zone in einem Seitenanzeigemodus befindet, in dem das Layout von Steuerelementen in der Zone geändert werden kann, z. B DesignDisplayMode. .

Wenn AllowLayoutChange für eine bestimmte Zone auf false festgelegt ist, gibt es eine Reihe von Aktionen, die Endbenutzer daran gehindert werden, Steuerelemente in der Zone auszuführen:

• Benutzer können Steuerelemente nicht in eine andere Zone ziehen, Steuerelemente innerhalb der Zone neu anordnen oder steuerelemente in die Zone verschieben.

• Eine Reihe von Eigenschaften, die sich auf die Benutzeroberfläche (UI) von WebPart Steuerelementen in der Zone auswirken, sind deaktiviert, sodass Benutzer diese Eigenschaften nicht bearbeiten können, während das Steuerelement mit den AppearanceEditorPart Steuerelementen und BehaviorEditorPart bearbeitet wird.

• Benutzer können der Zone über ein CatalogPart Steuerelement keine neuen Steuerelemente hinzufügen.

• Die Verben Schließen, Löschen, Minimieren und Wiederherstellen werden in Steuerelementen in der Zone nicht angezeigt.

Obwohl sich die Eigenschaft auf die AllowLayoutChange Möglichkeit von Endbenutzern auswirkt, das Layout einer Zone über die Benutzeroberfläche zu ändern, wirkt sie sich nicht auf die Möglichkeit aus, das Layout programmgesteuert zu ändern. Wenn AllowLayoutChange beispielsweise auf falsefestgelegt ist, können Benutzer Steuerelemente in der Zone nicht schließen, aber ein Entwickler kann die CloseWebPart Methode trotzdem aufrufen, um Steuerelemente programmgesteuert zu schließen.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.

Weitere Informationen

• AllowZoneChange
• ASP.NET Webpart-Steuerelemente