WebPartZoneBase.LayoutOrientation 屬性

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

取得或設定值，指出區域中的控制項是垂直排列或是水平排列。

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

屬性值

Orientation

Orientation 值，決定區域中控制項的排列方式。 預設方向是 Vertical。

例外狀況

ArgumentOutOfRangeException

此值不是其中一個列舉的 Orientation 值。

範例

下列程式代碼範例示範 控件上 WebPartZone 屬性的LayoutOrientation宣告式和程序設計用法。 如需完整的程式碼範例，包括程式代碼後置原始程式檔和包含此程式代碼中區域的.aspx頁面，請參閱 WebPartZoneBase 類別概觀。

請注意， LayoutOrientation 屬性在宣告式標記中指派給它的值。 當您將頁面載入瀏覽器之後，這個值會影響 WebPartZone1。 區域中的網頁元件控件會水平轉譯。

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

您可以按下 [ 切換版面配置方向 ] 按鈕來變更區域的方向。 切換方向的程式代碼發生在部分類別的下列程式代碼範例中。

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

備註

屬性 LayoutOrientation 會考慮如何在區域中配置網頁元件控制件。 使用預設 Vertical 方向時，控件會根據 ZoneIndex 每個控件的值，以由上至下排列方式呈現。 Horizontal使用方向時，控件會並排排列，受限於區域的寬度。

Internet Explorer 蝭 的高度WebPart控制項，以及包含該區域的高度。 Internet Explorer 會以相容性模式轉譯網頁， (與舊版瀏覽器) 回溯相容，或在標準模式中轉譯網頁， (取決於頁面) 中是否有 DOCTYPE 宣告。 如需這些模式的相關信息，請參閱 DHTML compatMode 屬性。 當 Internet Explorer 以標準模式呈現頁面時，在某些情況下，它不會調整表格中的數據格大小，即使單元格的 HTML 標記為 <td height="100%">。 因此， WebPart 控件及其包含區域會轉譯，讓控件不會延展到區域的完整高度。

這種轉譯會在兩種情況下發生。

• 當區域的 LayoutOrientation 屬性設定 Vertical為 時，您會明確地在區域上設定高度。 若要讓控件填滿區域的完整高度，請勿指定水平區域的高度。

• 當區域的 LayoutOrientation 屬性設定 Horizontal為 時，您不會明確設定區域的高度 (或自主控件) 。 若要讓控件填滿區域的完整高度，請在垂直區域中設定區域或控件的高度。

本主題中的程式碼範例示範屬性的 LayoutOrientation 一般用法。 如需示範高度相關轉譯問題的程式代碼範例，以及如何解決此問題，請參閱 Height 屬性。

另請參閱

• Orientation
• Height
• ASP.NET 網頁元件控制件