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.

Примеры

В следующем примере кода демонстрируется декларативное и программное использование LayoutOrientation свойства в элементе WebPartZone управления. Полный пример кода, включая исходный файл кода программной части и 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 объявления на странице). Сведения об этих режимах см. в описании свойства compatMode DHTML. Когда Internet Explorer отрисовывает страницу в режиме стандартов, в некоторых сценариях размер ячеек в таблицах не изменяется, даже если html-разметка <td height="100%">ячейки. В результате элементы управления и их содержащие зоны отображаются таким образом, WebPart чтобы элементы управления не простирались до полной высоты зоны.

Этот тип отрисовки происходит в двух случаях.

• Если для свойства зоны LayoutOrientation задано Verticalзначение , и вы явно задали высоту в зоне. Чтобы включить элементы управления для заполнения полной высоты зоны, не указывайте высоту горизонтальной зоны.

• Если для свойства зоны LayoutOrientation задано Horizontalзначение, и вы явно не задаете высоту зоны (или содержащихся в нем элементов управления). Чтобы включить элементы управления для заполнения полной высоты зоны, задайте высоту зоны или элементов управления в вертикальной зоне.

В примере кода в этом разделе демонстрируется нормальное использование LayoutOrientation свойства. Пример кода, демонстрирующий проблему отрисовки высоты и способы ее обхода, см. в описании Height свойства.

См. также раздел

• Orientation
• Height
• Элементы управления ASP.NET веб-части