Udostępnij za pośrednictwem

WebPartZoneBase.LayoutOrientation Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls.WebParts
Zestaw:
System.Web.dll

Pobiera lub ustawia wartość, która wskazuje, czy kontrolki w strefie są rozmieszczone w pionie, czy w poziomie.

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

Wartość właściwości

Orientation

Orientation Wartość określająca sposób rozmieszczania kontrolek w strefie. Domyślna orientacja to Vertical.

Wyjątki

ArgumentOutOfRangeException

Wartość nie jest jedną z wyliczeń Orientation .

Przykłady

Poniższy przykład kodu przedstawia deklaratywne i programowe użycie LayoutOrientation właściwości w kontrolce WebPartZone . Pełny przykład kodu, w tym plik źródłowy kodu i strona .aspx zawierająca strefę w tym kodzie, zobacz WebPartZoneBase omówienie klasy.

Zwróć uwagę, że LayoutOrientation właściwość ma przypisaną do niej wartość w adiustacji deklaratywnej. Ta wartość ma wpływ na WebPartZone1element po załadowaniu strony do przeglądarki. Kontrolki składników Web Part w strefie są renderowane w poziomie.

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

Możesz kliknąć przycisk Przełącz orientację układu , aby zmienić orientację strefy. Kod przełączania orientacji występuje w poniższym przykładzie kodu z klasy częściowej.

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

Uwagi

Właściwość LayoutOrientation dotyczy sposobu, w jaki składniki Web Part są określone w strefie. W przypadku orientacji domyślnej Vertical kontrolki są renderowane w układzie od góry do dołu zgodnie z wartością ZoneIndex każdej kontrolki. Z orientacją Horizontal kontrolki są rozmieszczone obok siebie, z zastrzeżeniem szerokości strefy.

Program Internet Explorer może wpływać na wysokość WebPart kontrolki oraz wysokość strefy, która ją zawiera. Program Internet Explorer renderuje strony internetowe w trybie zgodności (do tyłu zgodne z poprzednimi wersjami przeglądarki) lub w trybie standardów (określanym przez obecność DOCTYPE deklaracji na stronie). Aby uzyskać informacje o tych trybach, zobacz właściwość compatMode DHTML. Gdy program Internet Explorer renderuje stronę w trybie standardów, w niektórych scenariuszach nie zmienia rozmiaru komórek w tabelach, nawet jeśli znacznik HTML komórki to <td height="100%">. W związku z tym kontrolki i ich strefy zawierające są renderowane tak WebPart , aby kontrolki nie rozciągały się na pełną wysokość strefy.

Ten typ renderowania występuje w dwóch przypadkach.

  • Gdy właściwość strefy jest ustawiona LayoutOrientation na Vertical, a wysokość w strefie jest jawnie ustawiana. Aby umożliwić kontrolkom wypełnianie pełnej wysokości strefy, nie należy określać wysokości strefy poziomej.

  • Gdy właściwość strefy jest ustawiona LayoutOrientation na Horizontal, i nie ustawiasz jawnie wysokości strefy (lub zawartych kontrolek). Aby umożliwić kontrolkom wypełnianie pełnej wysokości strefy, ustaw wysokość strefy lub kontrolek w strefie pionowej.

Przykładowy kod w tym temacie przedstawia normalne użycie LayoutOrientation właściwości. Aby zapoznać się z przykładem kodu, który demonstruje problem z renderowaniem związanym z wysokością i sposobem jego obejścia, zobacz Height właściwość .

Dotyczy

Zobacz też