WebPartZoneBase.LayoutOrientation 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 kontrol dalam zona diatur secara vertikal atau horizontal.
public:
virtual property System::Web::UI::WebControls::Orientation LayoutOrientation { System::Web::UI::WebControls::Orientation get(); void set(System::Web::UI::WebControls::Orientation value); };
public virtual System.Web.UI.WebControls.Orientation LayoutOrientation { get; set; }
member this.LayoutOrientation : System.Web.UI.WebControls.Orientation with get, set
Public Overridable Property LayoutOrientation As Orientation
Nilai Properti
Nilai Orientation yang menentukan bagaimana kontrol dalam zona diatur. Orientasi defaultnya adalah Vertical.
Pengecualian
Nilai bukan salah satu nilai yang dijumlahkan Orientation .
Contoh
Contoh kode berikut menunjukkan penggunaan LayoutOrientation properti deklaratif dan terprogram 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 LayoutOrientation properti memiliki nilai yang ditetapkan untuknya dalam markup deklaratif. Nilai ini berdampak WebPartZone1
, setelah Anda memuat halaman ke browser. Kontrol Bagian Web di zona dirender secara horizontal.
<asp:WebPartZone
ID="WebPartZone1"
Runat="server"
LayoutOrientation="Vertical" >
<EditVerb Text="Edit WebPart" />
<SelectedPartChromeStyle BackColor="LightBlue" />
<ZoneTemplate>
<asp:BulletedList
ID="BulletedList1"
Runat="server"
DisplayMode="HyperLink"
Title="Favorite Links" >
<asp:ListItem Value="http://msdn.microsoft.com">
MSDN
</asp:ListItem>
<asp:ListItem Value="http://www.asp.net">
ASP.NET
</asp:ListItem>
<asp:ListItem Value="http://www.msn.com">
MSN
</asp:ListItem>
</asp:BulletedList>
<asp:Calendar ID="Calendar1" Runat="server"
Title="My Calendar" />
</ZoneTemplate>
</asp:WebPartZone>
<asp:WebPartZone
ID="WebPartZone1"
Runat="server"
LayoutOrientation="Vertical" >
<EditVerb Text="Edit WebPart" />
<SelectedPartChromeStyle BackColor="LightBlue" />
<ZoneTemplate>
<asp:BulletedList
ID="BulletedList1"
Runat="server"
DisplayMode="HyperLink"
Title="Favorite Links" >
<asp:ListItem Value="http://msdn.microsoft.com">
MSDN
</asp:ListItem>
<asp:ListItem Value="http://www.asp.net">
ASP.NET
</asp:ListItem>
<asp:ListItem Value="http://www.msn.com">
MSN
</asp:ListItem>
</asp:BulletedList>
<asp:Calendar ID="Calendar1" Runat="server"
Title="My Calendar" />
</ZoneTemplate>
</asp:WebPartZone>
Anda dapat mengklik tombol Alihkan Orientasi Tata Letak untuk mengubah orientasi zona. Kode untuk beralih orientasi terjadi dalam contoh kode berikut dari kelas parsial.
protected void Button2_Click(object sender, EventArgs e)
{
if (WebPartZone1.LayoutOrientation == Orientation.Vertical)
WebPartZone1.LayoutOrientation = Orientation.Horizontal;
else
WebPartZone1.LayoutOrientation = Orientation.Vertical;
Page_Load(sender, e);
}
Protected Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs)
If WebPartZone1.LayoutOrientation = Orientation.Vertical Then
WebPartZone1.LayoutOrientation = Orientation.Horizontal
Else
WebPartZone1.LayoutOrientation = Orientation.Vertical
End If
Page_Load(sender, e)
End Sub
Keterangan
Properti LayoutOrientation menyangkut bagaimana kontrol Bagian Web ditata di zona. Dengan orientasi default Vertical , kontrol dirender dalam pengaturan atas-ke-bawah, sesuai dengan ZoneIndex nilai setiap kontrol. Horizontal Dengan orientasi, kontrol diatur berdampingan, tergantung pada lebar zona.
Internet Explorer dapat mempengaruhi tinggi WebPart kontrol, dan tinggi zona yang memuatnya. Internet Explorer merender halaman web baik dalam mode kompatibilitas (kompatibel mundur dengan versi browser sebelumnya), atau dalam mode standar (ditentukan oleh adanya DOCTYPE
deklarasi di halaman). Untuk informasi tentang mode ini, lihat properti DHTML compatMode . Ketika Internet Explorer merender halaman dalam mode standar, dalam beberapa skenario itu tidak mengubah ukuran sel dalam tabel, bahkan ketika markup HTML sel adalah <td height="100%">
. Akibatnya, WebPart kontrol dan zona yang berisinya dirender sehingga kontrol tidak membentang ke ketinggian penuh zona.
Jenis penyajian ini terjadi dalam dua kasus.
Ketika properti zona LayoutOrientation diatur ke Vertical, dan Anda secara eksplisit mengatur tinggi pada zona tersebut. Untuk mengaktifkan kontrol untuk mengisi tinggi penuh zona, jangan tentukan tinggi zona horizontal.
Ketika properti zona LayoutOrientation diatur ke Horizontal, dan Anda tidak secara eksplisit mengatur tinggi zona (atau kontrol yang terkandung). Untuk mengaktifkan kontrol untuk mengisi tinggi penuh zona, atur tinggi zona atau kontrol di zona vertikal.
Contoh kode dalam topik ini menunjukkan penggunaan LayoutOrientation normal properti. Untuk contoh kode yang menunjukkan masalah penyajian terkait tinggi dan cara mengatasinya, lihat Height properti .