WebPartZoneBase.LayoutOrientation Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls.WebParts

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví hodnotu, která označuje, zda ovládací prvky v zóně jsou 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 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 na pozadí 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 na WebPartZone1načtení stránky do prohlížeče. Ovládací prvky webových částí v zóně jsou vykresleny 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>

Orientaci zóny můžete změnit kliknutím na tlačítko Přepnout orientaci rozložení . Kód pro přepnutí orientace se vyskytuje 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á rozložení ovládacích prvků webových částí v zóně. 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. Horizontal Při orientaci 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á ho obsahuje. Internet Explorer vykresluje webové stránky buď v režimu kompatibility (zpětně kompatibilní s předchozími verzemi prohlížeče), nebo ve standardním režimu (určeném přítomností DOCTYPE deklarace na stránce). Informace o těchto režimech naleznete v DHTML CompatMode vlastnost. Když Internet Explorer vykreslí stránku v režimu standardů, v některých scénářích nezmění velikost buněk v tabulkách, i když je kód HTML buňky .<td height="100%"> V důsledku toho WebPart jsou ovládací prvky a jejich obsahující zóna vykresleny tak, aby se ovládací prvky neroztahovaly do celé výšky zóny.

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

Když je vlastnost zóny LayoutOrientation nastavená na Verticalhodnotu a explicitně nastavíte výšku zóny. Pokud chcete ovládacím prvkům povolit vyplnění celé výšky zóny, nezadávejte výšku vodorovné zóny.
Pokud je vlastnost zóny LayoutOrientation nastavená na Horizontalhodnotu a nenastavíte explicitně výšku zóny (nebo obsažených ovládacích prvků). Pokud chcete ovládacím prvkům povolit vyplnění celé výšky 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 jak ho obejít, najdete ve Height vlastnosti .

Platí pro

Sdílet prostřednictvím