BaseDataList.GridLines-Eigenschaft
Ruft einen Wert ab, der angibt, ob der Rahmen zwischen den Zellen eines Datenauflistungssteuerelements angezeigt wird, oder legt diesen fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Overridable Property GridLines As GridLines
'Usage
Dim instance As BaseDataList
Dim value As GridLines
value = instance.GridLines
instance.GridLines = value
public virtual GridLines GridLines { get; set; }
public:
virtual property GridLines GridLines {
GridLines get ();
void set (GridLines value);
}
/** @property */
public GridLines get_GridLines ()
/** @property */
public void set_GridLines (GridLines value)
public function get GridLines () : GridLines
public function set GridLines (value : GridLines)
Eigenschaftenwert
Einer der GridLines-Werte. Der Standardwert ist Both.
Hinweise
Geben Sie mit der GridLines-Eigenschaft an, ob der Rahmen zwischen den Zellen eines Datenauflistungssteuerelements angezeigt wird. Diese Eigenschaft wird mit einem der GridLines-Enumerationswerte festgelegt. In der folgenden Tabelle sind die möglichen Werte aufgeführt.
Wert |
Beschreibung |
|---|---|
None |
Es wird kein Zellrahmen angezeigt. |
Horizontal |
Im Datenauflistungssteuerelement werden nur die oberen und unteren Rahmen der Zellen angezeigt. |
Vertical |
Im Datenlistensteuerelement werden nur die linken und rechten Rahmen der Zellen angezeigt. |
Both |
Im Datenauflistungssteuerelement werden alle Zellrahmen angezeigt. |
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der GridLines-Eigenschaft sowohl die horizontale als auch die vertikale Rasterlinie in einem datengebundenen Steuerelement angezeigt werden.
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<html>
<script runat="server">
Function CreateDataSource() As ICollection
' Create sample data for the DataGrid control.
Dim dt As DataTable = New DataTable()
Dim dr As DataRow
' Define the columns of the table.
dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
dt.Columns.Add(New DataColumn("StringValue", GetType(string)))
dt.Columns.Add(New DataColumn("CurrencyValue", GetType(double)))
' Populate the table with sample values.
Dim i As Integer
For i = 0 to 8
dr = dt.NewRow()
dr(0) = i
dr(1) = "Item " & i.ToString()
dr(2) = 1.23 * (i + 1)
dt.Rows.Add(dr)
Next i
Dim dv As DataView = New DataView(dt)
Return dv
End Function
Sub Page_Load(sender As Object, e As EventArgs)
' Load sample data only once when the page is first loaded.
If Not IsPostBack Then
ItemsGrid.DataSource = CreateDataSource()
ItemsGrid.DataBind()
End If
End Sub
Sub Index_Change(sender As Object, e As EventArgs)
ItemsGrid.GridLines = CType(GridLinesList.SelectedIndex, GridLines)
End Sub
</script>
<body>
<form runat=server>
<h3>BaseDataList GridLines Example</h3>
<asp:DataGrid id="ItemsGrid"
BorderColor="black"
BorderWidth="1"
CellPadding="3"
GridLines="Both"
AutoGenerateColumns="true"
runat="server">
<HeaderStyle BackColor="#00aaaa">
</HeaderStyle>
</asp:DataGrid>
<br>
<h4>Select the gridline style:</h4>
<table cellpadding="5">
<tr>
<td>
Gridline style:
</td>
</tr>
<tr>
<td>
<asp:DropDownList id="GridLinesList"
AutoPostBack="True"
OnSelectedIndexChanged="Index_Change"
runat="server">
<asp:ListItem Value="0">None</asp:ListItem>
<asp:ListItem Value="1">Horizontal</asp:ListItem>
<asp:ListItem Value="2">Vertical</asp:ListItem>
<asp:ListItem Value="3" Selected="True">Both</asp:ListItem>
</asp:DropDownList>
</td>
</tr>
</table>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<html>
<script runat="server">
ICollection CreateDataSource()
{
// Create sample data for the DataGrid control.
DataTable dt = new DataTable();
DataRow dr;
// Define the columns of the table.
dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
// Populate the table with sample values.
for (int i = 0; i < 9; i++)
{
dr = dt.NewRow();
dr[0] = i;
dr[1] = "Item " + i.ToString();
dr[2] = 1.23 * (i + 1);
dt.Rows.Add(dr);
}
DataView dv = new DataView(dt);
return dv;
}
void Page_Load(Object sender, EventArgs e)
{
// Load sample data only once when the page is first loaded.
if (!IsPostBack)
{
ItemsGrid.DataSource = CreateDataSource();
ItemsGrid.DataBind();
}
}
void Index_Change(Object sender, EventArgs e)
{
ItemsGrid.GridLines = (GridLines)GridLinesList.SelectedIndex;
}
</script>
<body>
<form runat=server>
<h3>BaseDataList GridLines Example</h3>
<asp:DataGrid id="ItemsGrid"
BorderColor="black"
BorderWidth="1"
CellPadding="3"
GridLines="Both"
AutoGenerateColumns="true"
runat="server">
<HeaderStyle BackColor="#00aaaa">
</HeaderStyle>
</asp:DataGrid>
<br>
<h4>Select the gridline style:</h4>
<table cellpadding="5">
<tr>
<td>
Gridline style:
</td>
</tr>
<tr>
<td>
<asp:DropDownList id="GridLinesList"
AutoPostBack="True"
OnSelectedIndexChanged="Index_Change"
runat="server">
<asp:ListItem Value="0">None</asp:ListItem>
<asp:ListItem Value="1">Horizontal</asp:ListItem>
<asp:ListItem Value="2">Vertical</asp:ListItem>
<asp:ListItem Value="3" Selected="True">Both</asp:ListItem>
</asp:DropDownList>
</td>
</tr>
</table>
</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
BaseDataList-Klasse
BaseDataList-Member
System.Web.UI.WebControls-Namespace
GridLines