WebPartZoneBase.LayoutOrientation Propiedad

Definición

Espacio de nombres:

System.Web.UI.WebControls.WebParts

Ensamblado:

System.Web.dll

Obtiene o establece un valor que indica si los controles de una zona están organizados vertical u 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 propiedad

Orientation

Un valor Orientation que determina cómo están organizados los controles de una zona. La orientación predeterminada es Vertical.

Excepciones

ArgumentOutOfRangeException

El valor no es ninguno de los valores de Orientation enumerados.

Ejemplos

En el ejemplo de código siguiente se muestra el uso declarativo y mediante programación de la LayoutOrientation propiedad en un WebPartZone control . Para obtener el ejemplo de código completo, incluido el archivo de código fuente subyacente y la página .aspx que contiene la zona de este código, consulte la información general de la WebPartZoneBase clase.

Observe que la LayoutOrientation propiedad tiene asignado un valor en el marcado declarativo. Este valor afecta a WebPartZone1, después de cargar la página en un explorador. Los controles de elementos web de la zona se representan 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>

Puede hacer clic en el botón Alternar orientación de diseño para cambiar la orientación de la zona. El código para alternar la orientación se produce en el ejemplo de código siguiente de la clase 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

Comentarios

La LayoutOrientation propiedad se refiere a cómo se diseñan los controles de elementos web en una zona. Con la orientación predeterminada Vertical , los controles se representan en una disposición de arriba a abajo, según el ZoneIndex valor de cada control. Con una Horizontal orientación, los controles se organizan en paralelo, sujeto al ancho de la zona.

Internet Explorer puede afectar al alto de un WebPart control y al alto de la zona que lo contiene. Internet Explorer representa páginas web en modo de compatibilidad (compatibles con versiones anteriores del explorador) o en modo estándar (determinada por la presencia de una DOCTYPE declaración en la página). Para obtener información sobre estos modos, vea la propiedad compatMode DHTML. Cuando Internet Explorer representa una página en modo estándar, en algunos escenarios no cambia el tamaño de las celdas de las tablas, incluso cuando el marcado HTML de una celda es <td height="100%">. Como resultado, WebPart los controles y su zona contenedora se representan para que los controles no se extiendan al alto completo de la zona.

Este tipo de representación se produce en dos casos.

• Cuando la propiedad de LayoutOrientation una zona se establece en y se establece Verticalexplícitamente el alto en la zona. Para permitir que los controles rellenen el alto completo de la zona, no especifique el alto de una zona horizontal.

• Cuando la propiedad de LayoutOrientation una zona se establece Horizontalen y no se establece explícitamente el alto de la zona (o de los controles contenidos). Para permitir que los controles rellenen el alto completo de la zona, establezca el alto de la zona o de los controles de una zona vertical.

En el ejemplo de código de este tema se muestra el uso normal de la LayoutOrientation propiedad . Para obtener un ejemplo de código que muestre el problema de representación relacionado con el alto y cómo solucionarlo, consulte la Height propiedad .

Consulte también

• Orientation
• Height
• controles de elementos web de ASP.NET