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