WebPartZoneBase.AllowLayoutChange Properti

Definisi

Ruang nama:

System.Web.UI.WebControls.WebParts

Rakitan:

System.Web.dll

Mendapatkan atau menetapkan nilai yang menunjukkan apakah tata letak WebPart kontrol dapat diubah dalam 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

Nilai Properti

Boolean

true jika tata letak dapat diubah; jika tidak, false. Default adalah true.

Atribut

ThemeableAttribute

Contoh

Contoh kode berikut menunjukkan penggunaan AllowLayoutChange deklaratif properti pada WebPartZone kontrol. Untuk contoh kode lengkap, termasuk file sumber code-behind dan halaman .aspx yang berisi zona dalam kode ini, lihat WebPartZoneBase gambaran umum kelas.

Perhatikan bahwa AllowLayoutChange properti diatur ke true, yang merupakan default. Jika Anda mengubah nilai menjadi false, setelah memuat halaman ke browser dan mengalihkan halaman ke mode tampilan desain, Anda tidak akan dapat menyeret kontrol di dalam atau ke zona tersebut 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>

Keterangan

Properti AllowLayoutChange hanya berlaku ketika zona berada dalam mode tampilan halaman di mana tata letak kontrol di zona dapat diubah, seperti DesignDisplayMode.

Ketika AllowLayoutChange diatur ke false pada zona tertentu, ada sejumlah tindakan yang dicegah pengguna akhir untuk melakukan kontrol di zona tersebut:

• Pengguna tidak dapat menyeret kontrol ke zona lain, menyusun ulang kontrol di dalam zona, atau memindahkan kontrol ke zona tersebut.

• Sejumlah properti yang memengaruhi antarmuka pengguna (UI) WebPart kontrol di zona dinonaktifkan sehingga pengguna tidak dapat mengedit properti tersebut saat kontrol sedang diedit menggunakan AppearanceEditorPart kontrol dan BehaviorEditorPart .

• Pengguna tidak dapat menambahkan kontrol baru ke zona dari CatalogPart kontrol.

• Kata kerja tutup, hapus, minimalkan, dan pulihkan tidak ditampilkan pada kontrol di zona tersebut.

AllowLayoutChange Meskipun properti memengaruhi kemampuan pengguna akhir untuk mengubah tata letak zona melalui UI, properti tidak memengaruhi kemampuan untuk mengubah tata letak secara terprogram. Misalnya, jika AllowLayoutChange diatur ke false, pengguna tidak dapat menutup kontrol di zona tersebut, tetapi pengembang masih dapat memanggil CloseWebPart metode untuk menutup kontrol secara terprogram.

Properti ini tidak dapat diatur oleh tema atau tema lembar gaya. Untuk informasi selengkapnya, lihat ThemeableAttribute dan ASP.NET Tema dan Kulit.

Lihat juga

• AllowZoneChange
• ASP.NET Kontrol Komponen Web