WebPartZoneBase.AllowLayoutChange Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
true
jika tata letak dapat diubah; jika tidak, false
. Default adalah true
.
- Atribut
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.