Freigeben über

WebPartZoneBase.AllowLayoutChange Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Layout von WebPart Steuerelementen innerhalb einer Zone geändert werden kann.

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

truewenn das Layout geändert werden kann; andernfalls . false Der Standardwert lautet 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 true", die Standardeinstellung ist, festgelegt ist. Wenn Sie den Wert falseändern, nachdem Sie die Seite in einen Browser geladen und die Seite in den Entwurfsanzeigemodus wechseln, können Sie keine Steuerelemente 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 DesignDisplayMode. B. .

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

  • Benutzer können Keine Steuerelemente 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 von WebPart Steuerelementen in der Zone auswirken, sind deaktiviert, sodass Benutzer diese Eigenschaften nicht bearbeiten können, während das Steuerelement mithilfe der AppearanceEditorPart Steuerelemente BehaviorEditorPart bearbeitet wird.

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

  • Die Verben "Schließen", "Löschen", "Minimieren" und "Wiederherstellen" werden für Steuerelemente in der Zone nicht angezeigt.

Obwohl sich die AllowLayoutChange Eigenschaft auf die Fähigkeit der Endbenutzer auswirkt, das Layout einer Zone über die Benutzeroberfläche zu ändern, wirkt sich dies nicht auf die Möglichkeit aus, das Layout programmgesteuert zu ändern. Wenn beispielsweise festgelegt falseist, AllowLayoutChange können Benutzer Steuerelemente in der Zone nicht schließen, aber ein Entwickler kann die CloseWebPart Methode weiterhin 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.

Gilt für:

Weitere Informationen