WebPart.Height Vlastnost

Definice

Získá nebo nastaví výšku zóny.

public:
 virtual property System::Web::UI::WebControls::Unit Height { System::Web::UI::WebControls::Unit get(); void set(System::Web::UI::WebControls::Unit value); };
[System.Web.UI.WebControls.WebParts.Personalizable]
public override System.Web.UI.WebControls.Unit Height { get; set; }
[<System.Web.UI.WebControls.WebParts.Personalizable>]
member this.Height : System.Web.UI.WebControls.Unit with get, set
Public Overrides Property Height As Unit

Hodnota vlastnosti

Objekt Unit , který označuje výšku objektu WebPartZone. Výchozí typ objektu Unit je pixely, jak je uvedeno vlastností Type .

Atributy

Příklady

Následující příklad kódu ukazuje problém vykreslování, který má vliv na výšku ovládacích WebPart prvků v .WebPartZone Pokud chcete tento problém předvést, musíte stránku spustit v Internet Explorer.

Všimněte si, že orientace zóny je nastavena na vodorovnou a že výška zóny a ovládací prvky v ní nejsou explicitně nastaveny. Výsledkem je, že v WebPartZone, kratší WebPart ovládací prvek se při vykreslování neroztáhne na výšku zóny. Pokud však odeberete DOCTYPE deklaraci ze stránky a znovu spustíte stránku, k problému nedojde, protože teď prohlížeč stránku nevykreslí v režimu standardů.

<%@ Page Language="C#"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Button1_Click(object sender, EventArgs e)
  {
    wpmgr.DisplayMode = WebPartManager.DesignDisplayMode;
  }
  protected void Button2_Click(object sender, EventArgs e)
  {
    wpmgr.DisplayMode = WebPartManager.BrowseDisplayMode;
  }

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="wpmgr" runat="server" />
      <asp:webpartzone id="WebPartZone1" runat="server" 
        layoutorientation="horizontal">
        <zonetemplate>
          <asp:textbox id="TextBox1" runat="server" title="Text input">
          </asp:textbox>
          <asp:calendar id="Calendar1" runat="server" title="Personal Calendar" />
        </zonetemplate>
      </asp:webpartzone>
      <asp:button id="Button1" runat="server" text="Design Mode" 
        onclick="Button1_Click" />
      <br />
      <asp:button id="Button2" runat="server" onclick="Button2_Click" 
        text="Browse Mode" />
    </form>
</body>
</html>
<%@ Page Language="VB"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    wpmgr.DisplayMode = WebPartManager.DesignDisplayMode
    
  End Sub

  Protected Sub Button2_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    wpmgr.DisplayMode = WebPartManager.BrowseDisplayMode
    
  End Sub
  
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="wpmgr" runat="server" />
      <asp:webpartzone id="WebPartZone1" runat="server" 
        layoutorientation="horizontal">
        <zonetemplate>
          <asp:textbox id="TextBox1" runat="server" title="Text input">
          </asp:textbox>
          <asp:calendar id="Calendar1" runat="server" title="Personal Calendar" />
        </zonetemplate>
      </asp:webpartzone>
      <asp:button id="Button1" runat="server" text="Design Mode" 
        onclick="Button1_Click" />
      <br />
      <asp:button id="Button2" runat="server" onclick="Button2_Click" 
        text="Browse Mode" />
    </form>
</body>
</html>

Pokud chcete zjistit, jak alternativní řešení (popsané v části Poznámky) funguje, zkuste k prvku přidat height atribut <asp:webpartzone> a zachovat DOCTYPE deklaraci na stránce. K přidání atributu do značky můžete použít následující kód:

Height="200px"

Spusťte stránku a oba WebPart ovládací prvky se roztáhnou, aby vyplnily explicitně deklarovanou výšku zóny.

S tímto příkladem kódu můžete také experimentovat a sledovat problém s vykreslováním souvisejícím s výškou v jiném scénáři, ke kterému dochází, když je zóna LayoutOrientation nastavená na Vertical. Odeberte existující LayoutOrientation atribut a jeho hodnotu z elementu <asp:webpartzone> , což způsobí, že orientace zóny se vrátí k výchozí svislé orientaci. Nastavte atribut height prvku <asp:webpartzone> na 200 pixelů, jak jste to udělali výše, a spusťte stránku. Výška zóny vypadá příliš velká a ovládací prvky nejsou úměrné výšce zóny. Teď odeberte atribut height a znovu spusťte stránku. Ovládací prvky se teď vykreslují vzhledem k výšce zóny.

Poznámky

Internet Explorer režimy vykreslování můžou ovlivnit výšku ovládacího prvku WebPart 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í deklarace DOCTYPE na stránce). Informace o těchto režimech naleznete v DHTML compatMode vlastnost.

Když Internet Explorer vykresluje stránku v režimu standardů, nemusí za určitých okolností měnit velikost buněk v tabulkách, i když je kód HTML buňky <td height="100%">. 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.

Pokud je Internet Explorer ve standardním režimu, ovládací prvky se nevykreslují tak, aby se v následujících případech roztahovaly na plnou výšku:

  • Pokud je vlastnost zóny LayoutOrientation nastavena Vertical 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ě orientované zóny.

  • Pokud je vlastnost zóny LayoutOrientation nastavena Horizontal a nenastavíte explicitně výšku 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 svisle orientované zóně.

Platí pro

Viz také