WebPartZoneBase.AllowLayoutChange Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta un valore che indica se è possibile modificare il layout dei controlli WebPart all'interno di una zona.

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

Valore della proprietà

Boolean

true se è possibile modificare il layout. In caso contrario, false. Il valore predefinito è true.

Attributi: ThemeableAttribute

Esempio

Nell'esempio di codice seguente viene illustrato l'uso dichiarativo della AllowLayoutChange proprietà in un WebPartZone controllo . Per l'esempio di codice completo, incluso il file di origine code-behind e la pagina .aspx che contiene la zona in questo codice, vedere la panoramica della WebPartZoneBase classe.

Si noti che la AllowLayoutChange proprietà è impostata su true, ovvero l'impostazione predefinita. Se si modifica il valore falsein , dopo aver caricato la pagina in un browser e cambiare la pagina in modalità di visualizzazione progettazione, non sarà possibile trascinare i controlli all'interno o nella WebPartZone2 zona.

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

Commenti

La AllowLayoutChange proprietà diventa effettiva solo quando una zona è in modalità di visualizzazione pagina in cui è possibile modificare il layout dei controlli nell'area, ad esempio DesignDisplayMode.

Quando AllowLayoutChange è impostato su false in una determinata zona, è possibile impedire agli utenti finali di eseguire controlli nella zona:

Gli utenti non possono trascinare i controlli in una zona diversa, ridisporre i controlli all'interno della zona o spostare i controlli nella zona.
Alcune proprietà che influiscono sull'interfaccia utente dei WebPart controlli nella zona sono disabilitate in modo che gli utenti non possano modificare tali proprietà mentre il controllo viene modificato utilizzando i AppearanceEditorPart controlli e BehaviorEditorPart .
Gli utenti non possono aggiungere nuovi controlli alla zona da un CatalogPart controllo .
I verbi di chiusura, eliminazione, riduzione a icona e ripristino non vengono visualizzati nei controlli nella zona.

Anche se la AllowLayoutChange proprietà influisce sulla capacità degli utenti finali di modificare il layout di una zona tramite l'interfaccia utente, non influisce sulla possibilità di modificare il layout a livello di codice. Ad esempio, se AllowLayoutChange è impostato su false, gli utenti non possono chiudere i controlli nella zona, ma uno sviluppatore potrebbe comunque chiamare il CloseWebPart metodo per chiudere i controlli a livello di codice.

Questa proprietà non può essere impostata da temi oppure temi di fogli di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e interfacce.

Si applica a

Condividi tramite