HtmlTableCell.VAlign-Eigenschaft
Ruft die vertikale Ausrichtung des Inhalts einer Zelle ab, die durch eine Instanz der HtmlTableCell-Klasse dargestellt wird, oder legt diese fest.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Property VAlign As String
'Usage
Dim instance As HtmlTableCell
Dim value As String
value = instance.VAlign
instance.VAlign = value
public string VAlign { get; set; }
public:
property String^ VAlign {
String^ get ();
void set (String^ value);
}
/** @property */
public String get_VAlign ()
/** @property */
public void set_VAlign (String value)
public function get VAlign () : String
public function set VAlign (value : String)
Eigenschaftenwert
Die vertikale Ausrichtung des Inhalts einer Zelle, die durch eine Instanz von HtmlTableCell dargestellt wird. Der Standardwert ist String.Empty und gibt an, dass diese Eigenschaft nicht festgelegt ist.
Hinweise
Geben Sie mit der VAlign-Eigenschaft die vertikale Ausrichtung des Inhalts in einer Zelle an, die durch eine Instanz der HtmlTableCell-Klasse dargestellt wird.
Hinweis
Das Festlegen dieser Eigenschaft wirkt sich nur auf die Zelle aus, die durch eine Instanz der HtmlTableCell-Klasse dargestellt wird. Um die gleiche vertikale Ausrichtung auf die Zellen einer ganzen Zeile in der Tabelle anzuwenden, legen Sie die VAlign-Eigenschaft der Zeile fest, die durch eine Instanz der HtmlTableRow-Klasse dargestellt wird.
In der folgenden Tabelle sind die Werte aufgeführt, die für diese Eigenschaft verwendet werden können.
Wert |
Beschreibung |
|---|---|
Top |
Richtet den Inhalt einer Zelle am oberen Rand der Zelle aus. |
Middle |
Richtet den Inhalt einer Zelle in der Mitte der Zelle aus. |
Bottom |
Richtet den Inhalt einer Zelle am unteren Rand der Zelle aus. |
Hinweis
Sie können auch BaseLine als Wert für diese Eigenschaft verwenden. Jedoch wird diese Feature nicht von allen Browsern unterstützt.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mit der VAlign-Eigenschaft die vertikale Ausrichtung des Zelleninhalts in einem HtmlTable-Steuerelement programmgesteuert festgelegt wird.
<%@ Page Language="VB" AutoEventWireup="True" %>
<script runat="server">
Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs)
Dim i As Integer
Dim j As Integer
' Iterate through the rows of the table.
For i = 0 To Table1.Rows.Count - 1
' Iterate through the cells of a row.
For j = 0 To Table1.Rows(i).Cells.Count - 1
' Update the properties of each cell.
Table1.Rows(i).Cells(j).Align = AlignSelect.Value
Table1.Rows(i).Cells(j).NoWrap = Convert.ToBoolean(NoWrapSelect.Value)
Table1.Rows(i).Cells(j).VAlign = VAlignSelect.Value
Next j
Next i
End Sub
</script>
<html>
<head>
<title>HtmlTableCell Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTableCell Example</h3>
<table id="Table1"
border="1"
bordercolor="black"
runat="server">
<tr>
<td>
Here is some content for Cell 1.
</td>
<td>
Here is some content for Cell 2.
</td>
</tr>
<tr>
<td width="100" height="100">
Here is some content for Cell 3.
</td>
<td width="100" height="100">
Here is some content for Cell 4.
</td>
</tr>
</table>
<hr>
Select the display settings for the cells in the table: <br><br>
Align:
<select id="AlignSelect"
runat="server">
<option value="Left" selected>Left</option>
<option value="Center">Center</option>
<option value="Right">Right</option>
</select>
NoWrap:
<select id="NoWrapSelect"
runat="server">
<option value="true">True</option>
<option value="false" selected>False</option>
</select>
VAlign:
<select id="VAlignSelect"
runat="server">
<option value="Top">Top</option>
<option value="Middle" selected>Middle</option>
<option value="Bottom">Bottom</option>
</select>
<br><br>
<input type="button"
value="Generate Table"
onserverclick="Button_Click"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<script runat="server">
void Button_Click(Object sender, EventArgs e)
{
// Iterate through the rows of the table.
for (int i = 0; i <= Table1.Rows.Count - 1; i++)
{
// Iterate through the cells of a row.
for (int j = 0; j <= Table1.Rows[i].Cells.Count - 1; j++)
{
// Update the properties of each cell.
Table1.Rows[i].Cells[j].Align = AlignSelect.Value;
Table1.Rows[i].Cells[j].NoWrap = Convert.ToBoolean(NoWrapSelect.Value);
Table1.Rows[i].Cells[j].VAlign = VAlignSelect.Value;
}
}
}
</script>
<html>
<head>
<title>HtmlTableCell Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTableCell Example</h3>
<table id="Table1"
border="1"
bordercolor="black"
runat="server">
<tr>
<td>
Here is some content for Cell 1.
</td>
<td>
Here is some content for Cell 2.
</td>
</tr>
<tr>
<td width="100" height="100">
Here is some content for Cell 3.
</td>
<td width="100" height="100">
Here is some content for Cell 4.
</td>
</tr>
</table>
<hr>
Select the display settings for the cells in the table: <br><br>
Align:
<select id="AlignSelect"
runat="server">
<option value="Left" selected>Left</option>
<option value="Center">Center</option>
<option value="Right">Right</option>
</select>
NoWrap:
<select id="NoWrapSelect"
runat="server">
<option value="true">True</option>
<option value="false" selected>False</option>
</select>
VAlign:
<select id="VAlignSelect"
runat="server">
<option value="Top">Top</option>
<option value="Middle" selected>Middle</option>
<option value="Bottom">Bottom</option>
</select>
<br><br>
<input type="button"
value="Generate Table"
onserverclick="Button_Click"
runat="server"/>
</form>
</body>
</html>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
HtmlTableCell-Klasse
HtmlTableCell-Member
System.Web.UI.HtmlControls-Namespace
HtmlTableCell.Align-Eigenschaft
HtmlTableCell.ColSpan-Eigenschaft
HtmlTableCell.NoWrap-Eigenschaft
HtmlTableCell.RowSpan-Eigenschaft