WebPartZoneBase.LayoutOrientation Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Získá nebo nastaví hodnotu, která označuje, zda jsou ovládací prvky v zóně uspořádány svisle nebo vodorovně.

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

Hodnota vlastnosti

Orientation

Hodnota Orientation , která určuje způsob uspořádání ovládacích prvků v zóně. Výchozí orientace je Vertical.

Výjimky

ArgumentOutOfRangeException

Hodnota není jednou z výčtových Orientation hodnot.

Příklady

Následující příklad kódu ukazuje deklarativní a programové použití LayoutOrientation vlastnosti WebPartZone ovládacího prvku. Úplný příklad kódu, včetně zdrojového souboru kódu a stránky .aspx, která obsahuje zónu v tomto kódu, najdete v přehledu WebPartZoneBase třídy.

Všimněte si, že LayoutOrientation vlastnost má přiřazenou hodnotu v deklarativním kódu. Tato hodnota má vliv WebPartZone1na načtení stránky do prohlížeče. Ovládací prvky webových částí v zóně se vykreslují vodorovně.

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

Pokud chcete změnit orientaci zóny, můžete kliknout na tlačítko Přepnout orientaci rozložení . Kód pro přepnutí orientace nastane v následujícím příkladu kódu z částečné třídy.

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

Poznámky

Vlastnost LayoutOrientation se týká způsobu, jakým jsou ovládací prvky webových částí rozloženy do zóny. Při výchozí Vertical orientaci se ovládací prvky vykreslují v uspořádání shora dolů podle ZoneIndex hodnoty každého ovládacího prvku. S orientací Horizontal jsou ovládací prvky uspořádány vedle sebe, v závislosti na šířce zóny.

Internet Explorer může ovlivnit výšku WebPart ovládacího prvku a výšku zóny, která ji obsahuje. Internet Explorer vykresluje webové stránky buď v režimu kompatibility (zpětně kompatibilní s předchozími verzemi prohlížeče), nebo v režimu standardů (určeném přítomností DOCTYPE deklarace na stránce). Informace o těchto režimech naleznete v DHTML compatMode vlastnost. Když Internet Explorer vykresluje stránku v režimu standardů, v některých scénářích nemění velikost buněk v tabulkách, i když je <td height="100%">kód HTML buňky . V důsledku toho se ovládací prvky a jejich obsahující zóna vykreslují tak, WebPart aby se ovládací prvky nepřetahovaly na plnou výšku zóny.

K tomuto typu vykreslování dochází ve dvou případech.

• Pokud je vlastnost zóny LayoutOrientation nastavena na Verticalhodnotu a explicitně nastavíte výšku zóny. Chcete-li povolit ovládacím prvkům vyplnit plnou výšku zóny, nezadávejte výšku vodorovné zóny.

• Pokud je vlastnost zóny LayoutOrientation nastavena na Horizontalhodnotu a není explicitně nastavena výška zóny (nebo obsažených ovládacích prvků). Chcete-li povolit ovládacím prvkům vyplnit plnou výšku zóny, nastavte výšku zóny nebo ovládacích prvků ve svislé zóně.

Příklad kódu v tomto tématu ukazuje normální použití LayoutOrientation vlastnosti. Příklad kódu, který ukazuje problém s vykreslováním souvisejícím s výškou a jeho alternativní řešení, najdete ve Height vlastnosti.

Viz také

• Orientation
• Height
• ovládací prvky webových částí ASP.NET