WebPartZoneBase.LayoutOrientation Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls.WebParts
Assemblagem:
System.Web.dll

Recebe ou define um valor que indica se os controlos numa zona estão dispostos vertical ou horizontalmente.

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

Valor de Propriedade

Orientation

Um valor que determina como os Orientation controlos numa zona são organizados. A orientação padrão é Vertical.

Exceções

ArgumentOutOfRangeException

O valor não é um dos valores enumerados Orientation .

Exemplos

O exemplo de código seguinte demonstra o uso declarativo e programático da LayoutOrientation propriedade num WebPartZone controlo. Para o exemplo completo do código, incluindo o ficheiro-fonte code-behind e a página .aspx que contém a zona neste código, veja a visão geral da WebPartZoneBase classe.

Note que a LayoutOrientation propriedade tem um valor atribuído na marcação declarativa. Este valor afeta WebPartZone1, depois de carregar a página num navegador. Os controlos Web Parts na zona são renderizados horizontalmente.

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

Podes clicar no botão Alternar Orientação do Layout para mudar a orientação da zona. O código para alternar a orientação ocorre no seguinte exemplo de código da classe parcial.

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

Observações

A LayoutOrientation propriedade diz respeito à forma como os controlos das Web Parts estão organizados numa zona. Com a orientação padrão Vertical , os controlos são renderizados de cima para baixo, de acordo com o ZoneIndex valor de cada controlo. Com uma Horizontal orientação, os controlos estão dispostos lado a lado, sujeitos à largura da zona.

Internet Explorer pode afetar a altura de um controlo WebPart e a altura da zona que o contém. Internet Explorer renderiza páginas web quer em modo de compatibilidade (compatível com versões anteriores do navegador), quer em modo standards (determinado pela presença de uma declaração DOCTYPE na página). Para informações sobre estes modos, consulte a propriedade DHTML compatMode . Quando Internet Explorer renderiza uma página em modo standard, em alguns cenários não redimensiona as células das tabelas, mesmo quando a marcação HTML de uma célula é <td height="100%">. Como resultado, WebPart os controlos e a sua zona de contenção são renderizados de modo a que os controlos não se estendam até à altura total da zona.

Este tipo de renderização ocorre em dois casos.

  • Quando a propriedade de LayoutOrientation uma zona está definida para Vertical, e se define explicitamente a altura na zona. Para permitir que os controlos preencham toda a altura da zona, não especifique a altura de uma zona horizontal.

  • Quando a propriedade de LayoutOrientation uma zona está definida para Horizontal, e não se define explicitamente a altura da zona (ou dos controlos contidos). Para permitir que os controlos preencham toda a altura da zona, defina a altura da zona ou dos controlos numa zona vertical.

O exemplo de código neste tópico demonstra o uso normal da LayoutOrientation propriedade. Para um exemplo de código que demonstre o problema de renderização relacionado com a altura e como contorná-lo, veja a Height propriedade.

Aplica-se a

Ver também