WebPartZoneBase.LayoutOrientation Properti

Definisi

Ruang nama:

System.Web.UI.WebControls.WebParts

Rakitan:

System.Web.dll

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

Orientation

Nilai Orientation yang menentukan bagaimana kontrol dalam zona diatur. Orientasi defaultnya adalah Vertical.

Pengecualian

ArgumentOutOfRangeException

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 .

Lihat juga

• Orientation
• Height
• ASP.NET Kontrol Bagian Web