WebPart.Height Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de hoogte van een zone op of stelt u deze in.
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
Waarde van eigenschap
Een Unit object dat de hoogte van een WebPartZoneobject aangeeft. Het standaardtype van een Unit is pixels, zoals aangegeven door de Type eigenschap.
- Kenmerken
Voorbeelden
In het volgende codevoorbeeld ziet u het renderingprobleem dat van invloed is op de hoogte van WebPart besturingselementen in een WebPartZone. Als u dit probleem wilt demonstreren, moet u de pagina uitvoeren in Internet Explorer.
Houd er rekening mee dat de afdrukstand van de zone is ingesteld op horizontaal en dat de hoogte van de zone en de besturingselementen in de zone niet expliciet zijn ingesteld. Het resultaat is dat in de WebPartZone, de kortere WebPart controle niet wordt uitgerekt tot de hoogte van de zone bij het weergeven. Als u de DOCTYPE declaratie echter van de pagina verwijdert en de pagina opnieuw uitvoert, treedt het probleem niet op, omdat de browser de pagina nu niet weergeeft in de standaardmodus.
<%@ 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>
Als u wilt zien hoe de tijdelijke oplossing (beschreven in de sectie Opmerkingen) werkt, voegt u een height kenmerk toe aan het <asp:webpartzone> element en houdt u de DOCTYPE declaratie op de pagina. U kunt de volgende code gebruiken om het kenmerk toe te voegen aan de tag:
Height="200px"
Voer de pagina uit en nu worden beide WebPart besturingselementen uitgerekt om de expliciet gedeclareerde hoogte van de zone te vullen.
U kunt ook experimenteren met dit codevoorbeeld om het probleem met de hoogtegerelateerde rendering in het andere scenario te observeren. Dit gebeurt wanneer de zone LayoutOrientation is ingesteld op Vertical. Verwijder het bestaande LayoutOrientation kenmerk en de bijbehorende waarde uit het <asp:webpartzone> element, waardoor de afdrukstand van de zone wordt teruggezet naar de standaard verticale stand. Stel het hoogtekenmerk voor het <asp:webpartzone> element in op 200 pixels, zoals u hierboven hebt gedaan en voer de pagina uit. De hoogte van de zone ziet er te groot uit en de besturingselementen zijn niet evenredig met de hoogte van de zone. Verwijder nu het hoogtekenmerk en voer de pagina opnieuw uit. De besturingselementen worden nu ten opzichte van de hoogte van de zone weergegeven.
Opmerkingen
Internet Explorer renderingmodi kunnen van invloed zijn op de hoogte van een WebPart-besturingselement en de hoogte van de zone die deze bevat. Internet Explorer webpagina's weergeeft in de compatibiliteitsmodus (achterwaarts compatibel met eerdere browserversies) of in de standaardenmodus (bepaald door de aanwezigheid van een declaratie van DOCTYPE op de pagina). Zie de eigenschap DHTML compatMode voor informatie over deze modi.
Wanneer Internet Explorer een pagina weergeeft in de standaardmodus, wordt in sommige gevallen het formaat van cellen in tabellen mogelijk niet gewijzigd, zelfs niet wanneer de HTML-opmaak van een cel is <td height="100%">. Als gevolg hiervan WebPart worden besturingselementen en de bijbehorende zone weergegeven, zodat de besturingselementen niet tot de volledige hoogte van de zone worden uitgerekt.
Wanneer Internet Explorer zich in de standaardmodus bevindt, worden besturingselementen in de volgende gevallen niet uitgerekt tot de volledige hoogte:
Wanneer de eigenschap van LayoutOrientation een zone is ingesteld op Vertical en u expliciet de hoogte van de zone instelt. Als u wilt dat besturingselementen de volledige hoogte van de zone kunnen vullen, geeft u niet de hoogte van een horizontaal georiënteerde zone op.
Wanneer de eigenschap van LayoutOrientation een zone is ingesteld op Horizontal en u niet expliciet de hoogte van de zone of van de ingesloten besturingselementen instelt. Als u wilt dat besturingselementen de volledige hoogte van de zone kunnen vullen, stelt u de hoogte van de zone of van de besturingselementen in een verticaal georiënteerde zone in.