DataGrid Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ein datengebundenes Listensteuerelement, das die Elemente aus einer Datenquelle in einer Tabelle anzeigt. Das DataGrid-Steuerelement ermöglicht Ihnen die Auswahl, Sortierung und Bearbeitung dieser Elemente.
public ref class DataGrid : System::Web::UI::WebControls::BaseDataList, System::Web::UI::INamingContainerpublic class DataGrid : System.Web.UI.WebControls.BaseDataList, System.Web.UI.INamingContainertype DataGrid = class
inherit BaseDataList
interface INamingContainerPublic Class DataGrid
Inherits BaseDataList
Implements INamingContainer- Vererbung
- Implementiert
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie sie das DataGrid -Steuerelement verwenden, um die Elemente in der Datenquelle anzuzeigen.
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<script language="C#" runat="server">
ICollection CreateDataSource()
{
DataTable dt = new DataTable();
DataRow dr;
dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
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)
{
if (!IsPostBack)
{
// Load this data only once.
ItemsGrid.DataSource= CreateDataSource();
ItemsGrid.DataBind();
}
}
</script>
<head runat="server">
<title>DataGrid Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataGrid Example</h3>
<b>Product List</b>
<asp:DataGrid id="ItemsGrid"
BorderColor="black"
BorderWidth="1"
CellPadding="3"
AutoGenerateColumns="true"
runat="server">
<HeaderStyle BackColor="#00aaaa">
</HeaderStyle>
</asp:DataGrid>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<script language="VB" runat="server">
Function CreateDataSource() As ICollection
Dim dt As New DataTable()
Dim dr As DataRow
dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
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 New DataView(dt)
Return dv
End Function 'CreateDataSource
Sub Page_Load(sender As Object, e As EventArgs)
If Not IsPostBack Then
' Load this data only once.
ItemsGrid.DataSource = CreateDataSource()
ItemsGrid.DataBind()
End If
End Sub 'Page_Load
</script>
<head runat="server">
<title>DataGrid Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataGrid Example</h3>
<b>Product List</b>
<asp:DataGrid id="ItemsGrid"
BorderColor="black"
BorderWidth="1"
CellPadding="3"
AutoGenerateColumns="true"
runat="server">
<HeaderStyle BackColor="#00aaaa">
</HeaderStyle>
</asp:DataGrid>
</form>
</body>
</html>
Im folgenden Codebeispiel wird die Verwendung des DataGrid Steuerelements für einen einfachen Warenkorb veranschaulicht.
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<script language="C#" runat="server">
DataTable Cart;
DataView CartView;
ICollection CreateDataSource()
{
DataTable dt = new DataTable();
DataRow dr;
dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
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)
{
if (Session["DG4_ShoppingCart"] == null)
{
Cart = new DataTable();
Cart.Columns.Add(new DataColumn("Item", typeof(string)));
Cart.Columns.Add(new DataColumn("Price", typeof(string)));
Session["DG4_ShoppingCart"] = Cart;
}
else
{
Cart = (DataTable)Session["DG4_ShoppingCart"];
}
CartView = new DataView(Cart);
ShoppingCart.DataSource = CartView;
ShoppingCart.DataBind();
if (!IsPostBack)
{
// Load this data only once.
ItemsGrid.DataSource= CreateDataSource();
ItemsGrid.DataBind();
}
}
void Grid_CartCommand(Object sender, DataGridCommandEventArgs e)
{
DataRow dr = Cart.NewRow();
// e.Item is the table row where the command is raised.
// For bound columns, the value is stored in the Text property of the TableCell.
TableCell itemCell = e.Item.Cells[2];
TableCell priceCell = e.Item.Cells[3];
string item = itemCell.Text;
string price = priceCell.Text;
if (((Button)e.CommandSource).CommandName == "AddToCart")
{
dr[0] = item;
dr[1] = price;
Cart.Rows.Add(dr);
}
else
{
// Remove from Cart.
CartView.RowFilter = "Item='" + item + "'";
if (CartView.Count > 0)
{
CartView.Delete(0);
}
CartView.RowFilter = "";
}
ShoppingCart.DataBind();
}
</script>
<head runat="server">
<title>DataGrid Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataGrid Example</h3>
<table cellpadding="5">
<tr valign="top">
<td>
<b>Product List</b>
<asp:DataGrid id="ItemsGrid"
BorderColor="black"
BorderWidth="1"
CellPadding="3"
AutoGenerateColumns="false"
OnItemCommand="Grid_CartCommand"
runat="server">
<HeaderStyle BackColor="#00aaaa">
</HeaderStyle>
<Columns>
<asp:ButtonColumn
HeaderText="Add to cart"
ButtonType="PushButton"
Text="Add"
CommandName="AddToCart" />
<asp:ButtonColumn
HeaderText="Remove from cart"
ButtonType="PushButton"
Text="Remove"
CommandName="RemoveFromCart" />
<asp:BoundColumn
HeaderText="Item"
DataField="StringValue"/>
<asp:BoundColumn
HeaderText="Price"
DataField="CurrencyValue"
DataFormatString="{0:c}">
<ItemStyle HorizontalAlign="right">
</ItemStyle>
</asp:BoundColumn>
</Columns>
</asp:DataGrid>
</td>
<td>
<b>Shopping Cart</b>
<asp:DataGrid id="ShoppingCart"
runat="server"
BorderColor="black"
BorderWidth="1"
GridLines="Both"
ShowFooter="false"
CellPadding="3"
CellSpacing="0">
<HeaderStyle BackColor="#00aaaa">
</HeaderStyle>
</asp:DataGrid>
</td>
</tr>
</table>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<script language="VB" runat="server">
Dim Cart As DataTable
Dim CartView As DataView
Function CreateDataSource() As ICollection
Dim dt As New DataTable()
Dim dr As DataRow
dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
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 New DataView(dt)
Return dv
End Function 'CreateDataSource
Sub Page_Load(sender As Object, e As EventArgs)
If Session("DG4_ShoppingCart") Is Nothing Then
Cart = New DataTable()
Cart.Columns.Add(New DataColumn("Item", GetType(String)))
Cart.Columns.Add(New DataColumn("Price", GetType(String)))
Session("DG4_ShoppingCart") = Cart
Else
Cart = CType(Session("DG4_ShoppingCart"), DataTable)
End If
CartView = New DataView(Cart)
ShoppingCart.DataSource = CartView
ShoppingCart.DataBind()
If Not IsPostBack Then
' Load this data only once.
ItemsGrid.DataSource = CreateDataSource()
ItemsGrid.DataBind()
End If
End Sub 'Page_Load
Sub Grid_CartCommand(sender As Object, e As DataGridCommandEventArgs)
Dim dr As DataRow = Cart.NewRow()
' e.Item is the table row where the command is raised.
' For bound columns, the value is stored in the Text property of the TableCell.
Dim itemCell As TableCell = e.Item.Cells(2)
Dim priceCell As TableCell = e.Item.Cells(3)
Dim item As String = itemCell.Text
Dim price As String = priceCell.Text
If CType(e.CommandSource, Button).CommandName = "AddToCart" Then
dr(0) = item
dr(1) = price
Cart.Rows.Add(dr)
Else
'Remove from Cart.
CartView.RowFilter = "Item" + ChrW(61) + "'" + item + "'"
If CartView.Count > 0 Then
CartView.Delete(0)
End If
CartView.RowFilter = ""
End If
ShoppingCart.DataBind()
End Sub 'Grid_CartCommand
</script>
<head runat="server">
<title>DataGrid Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataGrid Example</h3>
<table cellpadding="5">
<tr valign="top">
<td>
<b>Product List</b>
<asp:DataGrid id="ItemsGrid"
BorderColor="black"
BorderWidth="1"
CellPadding="3"
AutoGenerateColumns="false"
OnItemCommand="Grid_CartCommand"
runat="server">
<HeaderStyle BackColor="#00aaaa">
</HeaderStyle>
<Columns>
<asp:ButtonColumn
HeaderText="Add to cart"
ButtonType="PushButton"
Text="Add"
CommandName="AddToCart" />
<asp:ButtonColumn
HeaderText="Remove from cart"
ButtonType="PushButton"
Text="Remove"
CommandName="RemoveFromCart" />
<asp:BoundColumn
HeaderText="Item"
DataField="StringValue"/>
<asp:BoundColumn
HeaderText="Price"
DataField="CurrencyValue"
DataFormatString="{0:c}">
<ItemStyle HorizontalAlign="right">
</ItemStyle>
</asp:BoundColumn>
</Columns>
</asp:DataGrid>
</td>
<td>
<b>Shopping Cart</b>
<asp:DataGrid id="ShoppingCart"
runat="server"
BorderColor="black"
BorderWidth="1"
GridLines="Both"
ShowFooter="false"
CellPadding="3"
CellSpacing="0">
<HeaderStyle BackColor="#00aaaa">
</HeaderStyle>
</asp:DataGrid>
</td>
</tr>
</table>
</form>
</body>
</html>
Im folgenden Codebeispiel wird veranschaulicht, wie den vom Steuerelement generierten Tags und dynamisch Attribute <td> hinzugefügt werdenDataGrid.<tr>
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<script runat="server">
ICollection CreateDataSource()
{
DataTable dt = new DataTable();
DataRow dr;
dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
for (int i = 0; i < 5; 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)
{
if (!IsPostBack)
{
// Load this data only once.
ItemsGrid.DataSource = CreateDataSource();
ItemsGrid.DataBind();
}
}
void Item_Bound(Object sender, DataGridItemEventArgs e)
{
ListItemType itemType = (ListItemType)e.Item.ItemType;
if ((itemType != ListItemType.Header) &&
(itemType != ListItemType.Footer) &&
(itemType != ListItemType.Separator))
{
// Get the IntegerValue cell from the grid's column collection.
TableCell intCell = (TableCell)e.Item.Controls[0];
// Add attributes to the cell.
intCell.Attributes.Add("id", "intCell" + e.Item.ItemIndex.ToString());
intCell.Attributes.Add("OnClick",
"Update_intCell" +
e.Item.ItemIndex.ToString() +
"()");
// Add attributes to the row.
e.Item.Attributes.Add("id", "row" + e.Item.ItemIndex.ToString());
e.Item.Attributes.Add("OnDblClick",
"Update_row" +
e.Item.ItemIndex.ToString() +
"()");
}
}
</script>
<script type="text/vbscript">
sub Update_intCell0
Alert "You Selected Cell 0."
end sub
sub Update_intCell1
Alert "You Selected Cell 1."
end sub
sub Update_intCell2
Alert "You Selected Cell 2."
end sub
sub Update_intCell3
Alert "You Selected Cell 3."
end sub
sub Update_intCell4
Alert "You Selected Cell 4."
end sub
sub UpDate_row0
Alert "You selected the row 0."
end sub
sub UpDate_row1
Alert "You selected the row 1."
end sub
sub UpDate_row2
Alert "You selected the row 2."
end sub
sub UpDate_row3
Alert "You selected the row 3."
end sub
sub UpDate_row4
Alert "You selected the row 4."
end sub
</script>
<head runat="server">
<title>
Adding Attributes to the <td> and <tr> </title>
</head>
<body>
<form id="form1" runat="server">
<h3>
Adding Attributes to the <td> and <tr> <br />
Tags of a DataGrid Control
</h3>
<asp:DataGrid id="ItemsGrid" runat="server"
BorderColor="black"
BorderWidth="1"
CellPadding="3"
ShowFooter="true"
OnItemDataBound="Item_Bound"
AutoGenerateColumns="false">
<HeaderStyle BackColor="#00aaaa">
</HeaderStyle>
<FooterStyle BackColor="#00aaaa">
</FooterStyle>
<Columns>
<asp:BoundColumn HeaderText="Number"
DataField="IntegerValue">
<ItemStyle BackColor="yellow">
</ItemStyle>
</asp:BoundColumn>
<asp:BoundColumn
HeaderText="Item"
DataField="StringValue"/>
<asp:BoundColumn
HeaderText="Price"
DataField="CurrencyValue"
DataFormatString="{0:c}">
<ItemStyle HorizontalAlign="right">
</ItemStyle>
</asp:BoundColumn>
</Columns>
</asp:DataGrid>
<br /><br />
Click on one of the cells in the <b>Number</b> column to select the cell.
<br /><br />
Double click on a row to select a row.
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<script runat="server">
Function CreateDataSource() As ICollection
Dim dt As DataTable = New DataTable()
Dim dr As DataRow
Dim i As Integer
Dim dv As DataView
dt.Columns.Add(New DataColumn("IntegerValue", GetType(Integer)))
dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
For i = 0 to 4
dr = dt.NewRow()
dr(0) = i
dr(1) = "Item " + i.ToString()
dr(2) = 1.23 * (i+1)
dt.Rows.Add(dr)
Next i
dv = New DataView(dt)
CreateDataSource = dv
End Function
Sub Page_Load(sender As Object, e As EventArgs)
If Not IsPostBack
' Load this data only once.
ItemsGrid.DataSource = CreateDataSource()
ItemsGrid.DataBind()
End If
End Sub
Sub Item_Bound(sender As Object, e As DataGridItemEventArgs)
Dim itemType As ListItemType
Dim intCell As TableCell
itemType = CType(e.Item.ItemType, ListItemType)
If (itemType <> ListItemType.Header) And _
(itemType <> ListItemType.Footer) And _
(itemType <> ListItemType.Separator) Then
' Get the IntegerValue cell from the grid's column collection.
intCell = CType(e.Item.Controls(0), TableCell)
' Add attributes to the cell.
intCell.Attributes.Add("id", "intCell" + e.Item.ItemIndex.ToString())
intCell.Attributes.Add("OnClick", _
"Update_intCell" + _
e.Item.ItemIndex.ToString() + _
"()")
' Add attributes to the row.
e.Item.Attributes.Add("id", "row" + e.Item.ItemIndex.ToString())
e.Item.Attributes.Add("OnDblClick", _
"Update_row" + _
e.Item.ItemIndex.ToString() + _
"()")
End If
End Sub
</script>
<script type="text/vbscript">
sub Update_intCell0
Alert "You Selected Cell 0."
end sub
sub Update_intCell1
Alert "You Selected Cell 1."
end sub
sub Update_intCell2
Alert "You Selected Cell 2."
end sub
sub Update_intCell3
Alert "You Selected Cell 3."
end sub
sub Update_intCell4
Alert "You Selected Cell 4."
end sub
sub UpDate_row0
Alert "You selected the row 0."
end sub
sub UpDate_row1
Alert "You selected the row 1."
end sub
sub UpDate_row2
Alert "You selected the row 2."
end sub
sub UpDate_row3
Alert "You selected the row 3."
end sub
sub UpDate_row4
Alert "You selected the row 4."
end sub
</script>
<head runat="server">
<title>
Adding Attributes to the <td> and <tr> </title>
</head>
<body>
<form id="form1" runat="server">
<h3>
Adding Attributes to the <td> and <tr> <br />
Tags of a DataGrid Control
</h3>
<asp:DataGrid id="ItemsGrid" runat="server"
BorderColor="black"
BorderWidth="1"
CellPadding="3"
ShowFooter="true"
OnItemDataBound="Item_Bound"
AutoGenerateColumns="false">
<HeaderStyle BackColor="#00aaaa">
</HeaderStyle>
<FooterStyle BackColor="#00aaaa">
</FooterStyle>
<Columns>
<asp:BoundColumn HeaderText="Number"
DataField="IntegerValue">
<ItemStyle BackColor="yellow">
</ItemStyle>
</asp:BoundColumn>
<asp:BoundColumn
HeaderText="Item"
DataField="StringValue"/>
<asp:BoundColumn
HeaderText="Price"
DataField="CurrencyValue"
DataFormatString="{0:c}">
<ItemStyle HorizontalAlign="right">
</ItemStyle>
</asp:BoundColumn>
</Columns>
</asp:DataGrid>
<br /><br />
Click on one of the cells in the <b>Number</b> column to select the cell.
<br /><br />
Double click on a row to select a row.
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<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 Button_Click(Object sender, EventArgs e)
{
// Count the number of selected items in the DataGrid control.
int count = 0;
// Display the selected times.
Message.Text = "You Selected: <br />";
// Iterate through each item (row) in the DataGrid control and
// determine whether it is selected.
foreach (DataGridItem item in ItemsGrid.Items)
{
DetermineSelection(item, ref count);
}
// If no items are selected, display the appropriate message.
if (count == 0)
{
Message.Text = "No items selected";
}
}
void DetermineSelection(DataGridItem item, ref int count)
{
// Retrieve the SelectCheckBox CheckBox control from the specified
// item (row) in the DataGrid control.
CheckBox selection = (CheckBox)item.FindControl("SelectCheckBox");
// If the item is selected, display the appropriate message and
// increment the count of selected items.
if (selection != null)
{
if (selection.Checked)
{
Message.Text += "- " + item.Cells[1].Text + "<br />";
count++;
}
}
}
</script>
<head runat="server">
<title>DataGrid Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataGrid Example</h3>
<b>Product List</b>
<asp:DataGrid id="ItemsGrid"
BorderColor="black"
BorderWidth="1"
CellPadding="3"
AutoGenerateColumns="False"
runat="server">
<HeaderStyle BackColor="#00aaaa">
</HeaderStyle>
<Columns>
<asp:BoundColumn DataField="IntegerValue"
HeaderText="Item"/>
<asp:BoundColumn DataField="StringValue"
HeaderText="Description"/>
<asp:BoundColumn DataField="CurrencyValue"
HeaderText="Price"
DataFormatString="{0:c}">
<ItemStyle HorizontalAlign="Right">
</ItemStyle>
</asp:BoundColumn>
<asp:TemplateColumn HeaderText="Select Item">
<ItemTemplate>
<asp:CheckBox id="SelectCheckBox"
Text="Add to Cart"
Checked="False"
runat="server"/>
</ItemTemplate>
</asp:TemplateColumn>
</Columns>
</asp:DataGrid>
<br /><br />
<asp:Button id="SubmitButton"
Text="Submit"
OnClick = "Button_Click"
runat="server"/>
<br /><br />
<asp:Label id="Message"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<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 Button_Click(sender As Object, e As EventArgs)
' Count the number of selected items in the DataGrid control.
Dim count As Integer = 0
' Display the selected items.
Message.Text = "You Selected: <br />"
' Iterate through each item (row) in the DataGrid control
' and determine whether it is selected.
Dim item As DataGridItem
For Each item In ItemsGrid.Items
DetermineSelection(item, count)
Next
' If no items are selected, display the appropriate message.
If count = 0 Then
Message.Text = "No items selected"
End If
End Sub
Sub DetermineSelection(item As DataGridItem, ByRef count As Integer)
' Retrieve the SelectCheckBox CheckBox control from the specified
' item (row) in the DataGrid control.
Dim selection As CheckBox = CType(item.FindControl("SelectCheckBox"), CheckBox)
' If the item is selected, display the appropriate message and
' increment the count of selected items.
If Not selection Is Nothing Then
If selection.Checked Then
Message.Text &= "- " & item.Cells(1).Text & "<br />"
count = count + 1
End If
End If
End Sub
</script>
<head runat="server">
<title>DataGrid Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataGrid Example</h3>
<b>Product List</b>
<asp:DataGrid id="ItemsGrid"
BorderColor="black"
BorderWidth="1"
CellPadding="3"
AutoGenerateColumns="False"
runat="server">
<HeaderStyle BackColor="#00aaaa">
</HeaderStyle>
<Columns>
<asp:BoundColumn DataField="IntegerValue"
HeaderText="Item"/>
<asp:BoundColumn DataField="StringValue"
HeaderText="Description"/>
<asp:BoundColumn DataField="CurrencyValue"
HeaderText="Price"
DataFormatString="{0:c}">
<ItemStyle HorizontalAlign="Right">
</ItemStyle>
</asp:BoundColumn>
<asp:TemplateColumn HeaderText="Select Item">
<ItemTemplate>
<asp:CheckBox id="SelectCheckBox"
Text="Add to Cart"
Checked="False"
runat="server"/>
</ItemTemplate>
</asp:TemplateColumn>
</Columns>
</asp:DataGrid>
<br /><br />
<asp:Button id="SubmitButton"
Text="Submit"
OnClick = "Button_Click"
runat="server"/>
<br /><br />
<asp:Label id="Message"
runat="server"/>
</form>
</body>
</html>
Hinweise
In diesem Thema:
Einführung
Verwenden Sie das DataGrid -Steuerelement, um die Felder einer Datenquelle als Spalten in einer Tabelle anzuzeigen. Jede Zeile im DataGrid Steuerelement stellt einen Datensatz in der Datenquelle dar. Das DataGrid Steuerelement unterstützt auswahl, bearbeiten, löschen, paging und sortieren.
Achtung
Dieses Steuerelement kann verwendet werden, um Benutzereingaben anzuzeigen, die möglicherweise schädliche Clientskripts enthalten. Überprüfen Sie alle Informationen, die von einem Client auf ausführbare Skripts, SQL-Anweisungen oder anderen Code gesendet werden, bevor Sie sie in Ihrer Anwendung anzeigen. ASP.NET bietet eine Funktion zur Überprüfung von Eingabeanforderungen zum Blockieren von Skripts und HTML in Benutzereingaben. Validierungsserversteuerelemente werden auch bereitgestellt, um Benutzereingaben zu bewerten. Weitere Informationen finden Sie unter Syntax der Validierungsserversteuerung.
Unterschiedliche Spaltentypen bestimmen das Verhalten der Spalten im Steuerelement. In der folgenden Tabelle sind die verschiedenen Spaltentypen aufgeführt, die verwendet werden können.
| Spaltentyp | BESCHREIBUNG |
|---|---|
| BoundColumn | Zeigt eine Spalte an, die an ein Feld in einer Datenquelle gebunden ist. Jedes Element im Feld wird als Text angezeigt. Dies ist der Standardspaltentyp des Steuerelements DataGrid . |
| ButtonColumn | Zeigt eine Befehlsschaltfläche für jedes Element in der Spalte an. Dadurch können Sie eine Spalte mit benutzerdefinierten Schaltflächensteuerelementen erstellen, z Add . B. oder Remove Schaltflächen. |
| EditCommandColumn | Zeigt eine Spalte an, die Bearbeitungsbefehle für jedes Element in der Spalte enthält. |
| HyperLinkColumn | Zeigt den Inhalt jedes Elements in der Spalte als Link an. Der Inhalt der Spalte kann an ein Feld in einer Datenquelle oder an statischen Text gebunden werden. |
| TemplateColumn | Zeigt jedes Element in der Spalte nach einer angegebenen Vorlage an. Dadurch können Sie benutzerdefinierte Steuerelemente in der Spalte bereitstellen. |
Standardmäßig ist die AutoGenerateColumns -Eigenschaft auf truefestgelegt, wodurch ein BoundColumn Objekt für jedes Feld in der Datenquelle erstellt wird. Jedes Feld wird dann als Spalte im Steuerelement in der DataGrid Reihenfolge gerendert, in der jedes Feld in der Datenquelle angezeigt wird.
Sie können auch manuell steuern, welche Spalten im DataGrid Steuerelement angezeigt werden, indem Sie die AutoGenerateColumns -Eigenschaft auf false festlegen und dann die Spalten auflisten, die Sie zwischen den öffnenden und schließenden <Columns> Tags einschließen möchten. Die angegebenen Spalten werden der Columns Auflistung in der aufgeführten Reihenfolge hinzugefügt. Dadurch können Sie die Spalten im DataGrid Steuerelement programmgesteuert steuern.
Hinweis
Die Reihenfolge, in der die Spalten im DataGrid Steuerelement angezeigt werden, wird durch die Reihenfolge gesteuert, in der die Spalten in der Columns Auflistung angezeigt werden. Obwohl Sie die Reihenfolge der Spalten programmgesteuert ändern können, indem Sie die Columns Auflistung bearbeiten, ist es einfacher, die Spalten in der gewünschten Anzeigereihenfolge aufzulisten.
Explizit deklarierte Spalten können in Verbindung mit automatisch generierten Spalten angezeigt werden. Bei Verwendung beider werden explizit deklarierte Spalten zuerst gerendert, gefolgt von den automatisch generierten Spalten.
Hinweis
Automatisch generierte Spalten werden der Columns Auflistung nicht hinzugefügt.
Die Darstellung des DataGrid Steuerelements kann angepasst werden, indem die Stileigenschaften für die verschiedenen Teile des Steuerelements festgelegt werden. In der folgenden Tabelle sind die verschiedenen Stileigenschaften aufgeführt.
| Style-Eigenschaft | BESCHREIBUNG |
|---|---|
| AlternatingItemStyle | Gibt den Stil für wechselnde Elemente im Steuerelement an DataGrid . |
| EditItemStyle | Gibt den Stil für das Element an, das DataGrid im Steuerelement bearbeitet wird. |
| FooterStyle | Gibt die Formatvorlage für den Fußzeilenabschnitt im Steuerelement an DataGrid . |
| HeaderStyle | Gibt die Formatvorlage für den Headerabschnitt im Steuerelement an DataGrid . |
| ItemStyle | Gibt den Stil für die Elemente im Steuerelement an DataGrid . |
| PagerStyle | Gibt die Formatvorlage für den Seitenauswahlabschnitt des Steuerelements DataGrid an. |
| SelectedItemStyle | Gibt die Formatvorlage für das ausgewählte Element im Steuerelement an DataGrid . |
Sie können auch verschiedene Teile des Steuerelements ein- oder ausblenden. In der folgenden Tabelle sind die Eigenschaften aufgeführt, die steuern, welche Teile angezeigt oder ausgeblendet werden.
| Eigenschaft | BESCHREIBUNG |
|---|---|
| ShowFooter | Zeigt den Fußzeilenabschnitt des Steuerelements an oder blendet diese DataGrid aus. |
| ShowHeader | Zeigt den Headerabschnitt des Steuerelements an oder blendet diese DataGrid aus. |
Sie können die Darstellung des DataGrid Steuerelements steuern, indem Sie programmgesteuert Attribute zu den Tags und <tr> hinzufügen, die <td> vom Steuerelement im Browser gerendert werden. Attribute können programmgesteuert hinzugefügt werden, indem Code im Ereignishandler für das OnItemCreated Ereignis oder OnItemDataBound bereitgestellt wird.
Um dem <td> Tag ein Attribut hinzuzufügen, rufen Sie zuerst das TableCell Objekt ab, das die Zelle im DataGrid Steuerelement darstellt, dem Sie das Attribut hinzufügen möchten. Die Control.Controls Auflistung für die Item -Eigenschaft des -Objekts, das DataGridItemEventArgs an den Ereignishandler übergeben wird, kann verwendet werden, um das gewünschte TableCell Objekt abzurufen. Anschließend können Sie die AttributeCollection.Add -Methode der Attributes -Auflistung für das TableCell -Objekt verwenden, um dem <td> Tag Attribute hinzuzufügen.
Um dem <tr> Tag ein Attribut hinzuzufügen, rufen Sie zuerst das DataGridItem Objekt ab, das die Zeile im DataGrid Steuerelement darstellt, dem Sie das Attribut hinzufügen möchten. Die Item -Eigenschaft des -Objekts, das DataGridItemEventArgs an den Ereignishandler übergeben wird, kann verwendet werden, um das gewünschte DataGridItem Objekt abzurufen. Anschließend können Sie die AttributeCollection.Add -Methode der Attributes -Auflistung für das DataGridItem -Objekt verwenden, um dem <tr> Tag Attribute hinzuzufügen.
Zugriff
Weitere Informationen zur Verwendung dieses Steuerelement so konfigurieren, dass sie Markup generiert, das Accessibility Standards entspricht, finden Sie unter Barrierefreiheit in Visual Studio und ASP.NET und ASP.NET-Steuerelemente und Barrierefreiheit.
Deklarative Syntax
<asp:DataGrid
AccessKey="string"
AllowCustomPaging="True|False"
AllowPaging="True|False"
AllowSorting="True|False"
AutoGenerateColumns="True|False"
BackColor="color name|#dddddd"
BackImageUrl="uri"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
Caption="string"
CaptionAlign="NotSet|Top|Bottom|Left|Right"
CellPadding="integer"
CellSpacing="integer"
CssClass="string"
DataKeyField="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
EditItemIndex="integer"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
GridLines="None|Horizontal|Vertical|Both"
Height="size"
HorizontalAlign="NotSet|Left|Center|Right|Justify"
ID="string"
OnCancelCommand="CancelCommand event handler"
OnDataBinding="DataBinding event handler"
OnDeleteCommand="DeleteCommand event handler"
OnDisposed="Disposed event handler"
OnEditCommand="EditCommand event handler"
OnInit="Init event handler"
OnItemCommand="ItemCommand event handler"
OnItemCreated="ItemCreated event handler"
OnItemDataBound="ItemDataBound event handler"
OnLoad="Load event handler"
OnPageIndexChanged="PageIndexChanged event handler"
OnPreRender="PreRender event handler"
OnSelectedIndexChanged="SelectedIndexChanged event handler"
OnSortCommand="SortCommand event handler"
OnUnload="Unload event handler"
OnUpdateCommand="UpdateCommand event handler"
PageSize="integer"
runat="server"
SelectedIndex="integer"
ShowFooter="True|False"
ShowHeader="True|False"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
UseAccessibleHeader="True|False"
Visible="True|False"
Width="size"
>
<AlternatingItemStyle />
<Columns>
<asp:BoundColumn
DataField="string"
DataFormatString="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
ReadOnly="True|False"
SortExpression="string"
Visible="True|False"
>
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:BoundColumn>
<asp:ButtonColumn
ButtonType="LinkButton|PushButton"
CausesValidation="True|False"
CommandName="string"
DataTextField="string"
DataTextFormatString="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
SortExpression="string"
Text="string"
ValidationGroup="string"
Visible="True|False"
>
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:ButtonColumn>
<asp:EditCommandColumn
ButtonType="LinkButton|PushButton"
CancelText="string"
CausesValidation="True|False"
EditText="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
SortExpression="string"
UpdateText="string"
ValidationGroup="string"
Visible="True|False"
>
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:EditCommandColumn>
<asp:HyperLinkColumn
DataNavigateUrlField="string"
DataNavigateUrlFormatString="string"
DataTextField="string"
DataTextFormatString="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
NavigateUrl="uri"
SortExpression="string"
Target="string|_blank|_parent|_search|_self|_top"
Text="string"
Visible="True|False"
>
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:HyperLinkColumn>
<asp:TemplateColumn
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
SortExpression="string"
Visible="True|False"
>
<FooterStyle />
<HeaderStyle />
<ItemStyle />
<EditItemTemplate>
<!-- child controls -->
</EditItemTemplate>
<FooterTemplate>
<!-- child controls -->
</FooterTemplate>
<HeaderTemplate>
<!-- child controls -->
</HeaderTemplate>
<ItemTemplate>
<!-- child controls -->
</ItemTemplate>
</asp:TemplateColumn>
</Columns>
<EditItemStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
<PagerStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalAlign="NotSet|Left|Center|Right|Justify"
Mode="NextPrev|NumericPages"
NextPageText="string"
OnDisposed="Disposed event handler"
PageButtonCount="integer"
Position="Bottom|Top|TopAndBottom"
PrevPageText="string"
VerticalAlign="NotSet|Top|Middle|Bottom"
Visible="True|False"
Width="size"
Wrap="True|False"
/>
<SelectedItemStyle />
</asp:DataGrid>
Konstruktoren
| DataGrid() |
Initialisiert eine neue Instanz der DataGrid-Klasse. |
Felder
| CancelCommandName |
Stellt den Namen des |
| DeleteCommandName |
Stellt den Namen des Delete-Befehls dar. Dieses Feld ist schreibgeschützt. |
| EditCommandName |
Stellt den Namen des Edit-Befehls dar. Dieses Feld ist schreibgeschützt. |
| NextPageCommandArgument |
Stellt das Argument des Next-Befehls dar. Dieses Feld ist schreibgeschützt. |
| PageCommandName |
Stellt den Namen des Page-Befehls dar. Dieses Feld ist schreibgeschützt. |
| PrevPageCommandArgument |
Stellt das Argument des Prev-Befehls dar. Dieses Feld ist schreibgeschützt. |
| SelectCommandName |
Stellt den Namen des Select-Befehls dar. Dieses Feld ist schreibgeschützt. |
| SortCommandName |
Stellt den Namen des Sort-Befehls dar. Dieses Feld ist schreibgeschützt. |
| UpdateCommandName |
Stellt den Namen des Update-Befehls dar. Dieses Feld ist schreibgeschützt. |
Eigenschaften
| AccessKey |
Ruft die Zugriffstaste ab, mit der Sie schnell zum Webserversteuerelement navigieren können, oder legt diese fest. (Geerbt von WebControl) |
| Adapter |
Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control) |
| AllowCustomPaging |
Ruft einen Wert ab, der angibt, ob die benutzerdefinierte Paginierung aktiviert ist, oder legt diesen fest. |
| AllowPaging |
Ruft einen Wert ab, der angibt, ob die Paginierung aktiviert ist, oder legt diesen fest. |
| AllowSorting |
Ruft einen Wert ab, der angibt, ob das Sortieren aktiviert ist, oder legt diesen fest. |
| AlternatingItemStyle |
Ruft die Stileigenschaften für abwechselnde Elemente im DataGrid-Steuerelement ab. |
| AppRelativeTemplateSourceDirectory |
Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest. (Geerbt von Control) |
| Attributes |
Ruft die Auflistung von beliebigen Attributen (nur für die Darstellung) ab, die keinen Eigenschaften des Steuerelements entsprechen. (Geerbt von WebControl) |
| AutoGenerateColumns |
Ruft einen Wert ab, der angibt, ob BoundColumn-Objekte im DataGrid-Steuerelement für jedes Feld in der Datenquelle automatisch erstellt und angezeigt werden, oder legt diesen fest. |
| BackColor |
Ruft die Hintergrundfarbe des Webserversteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| BackImageUrl |
Ruft die URL eines Bildes ab, das im Hintergrund des DataGrid-Steuerelements angezeigt werden soll, oder legt diese fest. |
| BindingContainer |
Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Geerbt von Control) |
| BorderColor |
Ruft die Rahmenfarbe des Websteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| BorderStyle |
Ruft die Rahmenart des Webserversteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| BorderWidth |
Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| Caption |
Ruft den Text ab, der in einem HTML-Beschriftungselement im Steuerelement gerendert werden soll, oder legt diesen Text fest. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern. (Geerbt von BaseDataList) |
| CaptionAlign |
Ruft die horizontale oder die vertikale Position des HTML-Beschriftungselements in einem Steuerelement ab oder legt diese fest. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern. (Geerbt von BaseDataList) |
| CellPadding |
Ruft den Abstand zwischen dem Inhalt einer Zelle und ihrem Rahmen ab oder legt diesen fest. (Geerbt von BaseDataList) |
| CellSpacing |
Ruft den Abstand zwischen den Zellen ab oder legt diesen fest. (Geerbt von BaseDataList) |
| ChildControlsCreated |
Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Geerbt von Control) |
| ClientID |
Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Geerbt von Control) |
| ClientIDMode |
Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest. (Geerbt von Control) |
| ClientIDSeparator |
Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt. (Geerbt von Control) |
| Columns |
Ruft eine Auflistung von Objekten ab, die die Spalten des DataGrid-Steuerelements darstellen. |
| Context |
Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab. (Geerbt von Control) |
| Controls |
Ruft ein ControlCollection-Objekt ab, das eine Auflistung von untergeordneten Steuerelementen eines Datenauflistungssteuerelements enthält. (Geerbt von BaseDataList) |
| ControlStyle |
Ruft den Stil des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| ControlStyleCreated |
Ruft einen Wert ab, der angibt, ob ein Style-Objekt für die ControlStyle-Eigenschaft erstellt wurde. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| CssClass |
Ruft die vom Webserversteuerelement auf dem Client gerenderte CSS-Klasse (Cascading Style Sheet) ab oder legt diese fest. (Geerbt von WebControl) |
| CurrentPageIndex |
Ruft den Index der derzeit angezeigten Seite ab oder legt diesen fest. |
| DataItemContainer |
Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird. (Geerbt von Control) |
| DataKeyField |
Ruft das Schlüsselfeld in der Datenquelle ab, die von der DataSource-Eigenschaft angegeben wurde, oder legt dieses fest. (Geerbt von BaseDataList) |
| DataKeys |
Ruft ein DataKeyCollection-Objekt ab, in dem die Schlüsselwerte aller Datensätze in einem Datenauflistungssteuerelement gespeichert sind. (Geerbt von BaseDataList) |
| DataKeysArray |
Ruft ein ArrayList-Objekt ab, in dem die Schlüsselwerte aller Datensätze in einem Datenauflistungssteuerelement enthalten sind. (Geerbt von BaseDataList) |
| DataKeysContainer |
Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird. (Geerbt von Control) |
| DataMember |
Ruft in einer Datenquelle mit mehreren Membern einen bestimmten Datenmember ab, der an ein Datenauflistungssteuerelement gebunden werden soll, oder legt diesen fest. (Geerbt von BaseDataList) |
| DataSource |
Ruft die Quelle mit einer Werteliste ab, die zum Auffüllen der Elemente im Steuerelement verwendet wird, oder legt diese fest. (Geerbt von BaseDataList) |
| DataSourceID |
Ruft die ID-Eigenschaft des Datenquellen-Steuerelements ab, von dem das Datenauflistungssteuerelement seine Datenquelle abrufen soll, oder legt diese Eigenschaft fest. (Geerbt von BaseDataList) |
| DesignMode |
Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control) |
| EditItemIndex |
Ruft den Index eines Elements im zu bearbeitenden DataGrid-Steuerelement ab oder legt diesen fest. |
| EditItemStyle |
Ruft die Stileigenschaften für das zur Bearbeitung im DataGrid-Steuerelement ausgewählte Element ab. |
| Enabled |
Ruft einen Wert ab, der angibt, ob das Webserversteuerelement aktiviert ist, oder legt diesen fest. (Geerbt von WebControl) |
| EnableTheming |
Ruft einen Wert ab, der angibt, ob für dieses Steuerelement Designs gelten, oder legt diesen fest. (Geerbt von WebControl) |
| EnableViewState |
Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest. (Geerbt von Control) |
| Events |
Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control) |
| Font |
Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind. (Geerbt von WebControl) |
| FooterStyle |
Ruft die Stileigenschaften des Footerzeilenbereichs im DataGrid-Steuerelement ab. |
| ForeColor |
Ruft die Vordergrundfarbe (i. A. die Textfarbe) für das Webserversteuerelement ab oder legt diese fest. (Geerbt von WebControl) |
| GridLines |
Ruft einen Wert ab, der angibt, ob der Rahmen zwischen den Zellen eines Datenauflistungssteuerelements angezeigt wird, oder legt diesen fest. (Geerbt von BaseDataList) |
| HasAttributes |
Ruft einen Wert ab, der angibt, ob für das Steuerelement Attribute festgelegt wurden. (Geerbt von WebControl) |
| HasChildViewState |
Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind. (Geerbt von Control) |
| HeaderStyle |
Ruft die Stileigenschaften des Headerzeilenbereichs im DataGrid-Steuerelement ab. |
| Height |
Ruft die Höhe des Webserversteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| HorizontalAlign |
Ruft die horizontale Ausrichtung eines Datenauflistungssteuerelements in dessen Container ab oder legt diese fest. (Geerbt von BaseDataList) |
| ID |
Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control) |
| IdSeparator |
Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab. (Geerbt von Control) |
| Initialized |
Ruft einen Wert ab, der angibt, ob das Steuerelement initialisiert wurde. (Geerbt von BaseDataList) |
| IsBoundUsingDataSourceID |
Ruft einen Wert ab, der angibt, ob die DataSourceID-Eigenschaft festgelegt ist. (Geerbt von BaseDataList) |
| IsChildControlStateCleared |
Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen. (Geerbt von Control) |
| IsEnabled |
Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist. (Geerbt von WebControl) |
| IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert. (Geerbt von Control) |
| IsViewStateEnabled |
Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Geerbt von Control) |
| Items |
Ruft eine Auflistung der DataGridItem-Objekte ab, die die einzelnen Elemente im DataGrid-Steuerelement darstellen. |
| ItemStyle |
Ruft die Stileigenschaften für die Elemente im DataGrid-Steuerelement ab. |
| LoadViewStateByID |
Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt. (Geerbt von Control) |
| NamingContainer |
Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann. (Geerbt von Control) |
| Page |
Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält. (Geerbt von Control) |
| PageCount |
Ruft die Anzahl der für die Anzeige der Elemente im DataGrid-Steuerelement insgesamt benötigten Seiten ab. |
| PagerStyle |
Ruft die Stileigenschaften für den Paginierungsbereich des DataGrid-Steuerelements ab. |
| PageSize |
Ruft die Anzahl der Elemente ab, die auf einer einzelnen Seite des DataGrid-Steuerelements angezeigt werden sollen, oder legt diese fest. |
| Parent |
Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab. (Geerbt von Control) |
| RenderingCompatibility |
Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind. (Geerbt von Control) |
| RequiresDataBinding |
Ruft einen Wert ab, der angibt, ob das Datenauflistungssteuerelement an seine angegebene Datenquelle gebunden werden muss, oder legt diesen fest. (Geerbt von BaseDataList) |
| SelectArguments |
Ruft ein DataSourceSelectArguments-Objekt ab, das vom datengebundenen Steuerelement beim Abrufen von Daten aus einem Datenquellen-Steuerelement verwendet wird. (Geerbt von BaseDataList) |
| SelectedIndex |
Ruft den Index des ausgewählten Elements im DataGrid-Steuerelement ab oder legt diesen fest. |
| SelectedItem |
Ruft ein DataGridItem-Objekt ab, das das im DataGrid-Steuerelement ausgewählte Element darstellt. |
| SelectedItemStyle |
Ruft die Stileigenschaften für das derzeit im DataGrid-Steuerelement ausgewählte Element ab. |
| ShowFooter |
Ruft einen Wert ab, der angibt, ob die Footerzeile im DataGrid-Steuerelement angezeigt wird, oder legt diesen fest. |
| ShowHeader |
Ruft einen Wert ab, der angibt, ob die Headerzeile im DataGrid-Steuerelement angezeigt wird, oder legt diesen fest. |
| Site |
Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control) |
| SkinID |
Ruft das Design ab, das auf das Steuerelement angewendet werden soll. (Geerbt von WebControl) |
| Style |
Ruft eine Auflistung der Textattribute ab, die im äußeren Tag des Webserversteuerelements als Formatvorlagenattribut gerendert werden. (Geerbt von WebControl) |
| SupportsDisabledAttribute |
Ruft einen Wert ab, der angibt, ob vom Steuerelement das |
| TabIndex |
Ruft den Index der Aktivierreihenfolge des Webserversteuerelements ab oder legt diesen fest. (Geerbt von WebControl) |
| TagKey |
Ruft den HtmlTextWriterTag-Wert für das DataGrid-Steuerelement ab. |
| TagKey |
Ruft den HtmlTextWriterTag-Wert ab, der diesem Webserversteuerelement entspricht. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| TagName |
Ruft den Namen des Steuerelementtags ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| TemplateControl |
Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest. (Geerbt von Control) |
| TemplateSourceDirectory |
Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist. (Geerbt von Control) |
| ToolTip |
Ruft den Text ab, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird, oder legt diesen fest. (Geerbt von WebControl) |
| UniqueID |
Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control) |
| UseAccessibleHeader |
Ruft einen Wert ab, der angibt, ob das Datenauflistungssteuerelement den zugehörigen Header in einem barrierefreien Format rendert, oder legt diesen Wert fest. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern. (Geerbt von BaseDataList) |
| ValidateRequestMode |
Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft. (Geerbt von Control) |
| ViewState |
Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von Control) |
| ViewStateIgnoresCase |
Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird. (Geerbt von Control) |
| ViewStateMode |
Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest. (Geerbt von Control) |
| VirtualItemCount |
Ruft bei Verwendung von benutzerdefiniertem Paging die virtuelle Anzahl von Elementen im DataGrid-Steuerelement ab oder legt diese fest. |
| Visible |
Ruft einen Wert ab, der angibt, ob ein Serversteuerelement auf der Seite als Benutzeroberfläche gerendert wird. (Geerbt von Control) |
| Width |
Ruft die Breite des Webserver-Steuerelements ab oder legt sie fest. (Geerbt von WebControl) |
Methoden
| AddAttributesToRender(HtmlTextWriter) |
Fügt dem angegebenen HtmlTextWriterTag die darzustellenden HTML-Attribute und -Stile hinzu. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| AddedControl(Control, Int32) |
Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde. (Geerbt von Control) |
| AddParsedSubObject(Object) |
Benachrichtigt das Serversteuerelement, dass entweder ein XML- oder ein HTML-Element analysiert wurde, und fügt das Element der ControlCollection-Auflistung des Serversteuerelements hinzu. (Geerbt von BaseDataList) |
| ApplyStyle(Style) |
Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement und überschreibt hierbei alle vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| ApplyStyleSheetSkin(Page) |
Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement. (Geerbt von Control) |
| BeginRenderTracing(TextWriter, Object) |
Startet die Entwurfszeitablaufverfolgung des Renderns von Daten. (Geerbt von Control) |
| BuildProfileTree(String, Boolean) |
Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control) |
| ClearCachedClientID() |
Legt den zwischengespeicherten ClientID-Wert auf |
| ClearChildControlState() |
Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildState() |
Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildViewState() |
Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearEffectiveClientIDMode() |
Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest. (Geerbt von Control) |
| CopyBaseAttributes(WebControl) |
Kopiert die nicht vom Style-Objekt gekapselten Eigenschaften aus dem angegebenen Webserversteuerelement in das Webserversteuerelement, von dem aus diese Methode aufgerufen wird. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| CreateChildControls() |
Erstellt ein untergeordnetes Steuerelement unter Verwendung des Ansichtszustands. (Geerbt von BaseDataList) |
| CreateColumnSet(PagedDataSource, Boolean) |
Erstellt den Satz von Spalten, der zum Erstellen der Steuerelementhierarchie verwendet werden soll. Wenn AutoGenerateColumns auf true festgelegt ist, werden die Spalten gemäß der Datenquelle erstellt und an den in der Columns-Auflistung definierten Spaltensatz angehängt. |
| CreateControlCollection() |
Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (sowohl literale als auch Serversteuerelemente) des Serversteuerelements enthält. (Geerbt von Control) |
| CreateControlHierarchy(Boolean) |
Erstellt die Steuerelementhierarchie, die für das Rendering von DataGrid verwendet wird. |
| CreateControlStyle() |
Erstellt einen neuen Steuerelementstil. |
| CreateDataSourceSelectArguments() |
Erstellt ein vom datengebundenen Steuerelement verwendetes DataSourceSelectArguments-Standardobjekt, wenn keine Argumente angegeben wurden. (Geerbt von BaseDataList) |
| CreateItem(Int32, Int32, ListItemType) |
Erstellt ein DataGridItem-Objekt. |
| DataBind() |
Bindet das Steuerelement und alle seine untergeordneten Steuerelemente an die angegebene Datenquelle. (Geerbt von BaseDataList) |
| DataBind(Boolean) |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen. (Geerbt von Control) |
| DataBindChildren() |
Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| Dispose() |
Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird. (Geerbt von Control) |
| EndRenderTracing(TextWriter, Object) |
Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten. (Geerbt von Control) |
| EnsureChildControls() |
Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control) |
| EnsureDataBound() |
Überprüft vor dem Aufrufen der DataBind()-Methode, ob für das Datenauflistungssteuerelement eine Datenbindung erforderlich ist und ob ein gültiges Datenquellen-Steuerelement angegeben wurde. (Geerbt von BaseDataList) |
| EnsureID() |
Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen. (Geerbt von Control) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| FindControl(String) |
Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen |
| FindControl(String, Int32) |
Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen |
| Focus() |
Legt den Eingabefokus auf ein Steuerelement fest. (Geerbt von Control) |
| GetData() |
Gibt ein durch IEnumerable implementiertes Objekt zurück, das die Datenquelle darstellt. (Geerbt von BaseDataList) |
| GetDesignModeState() |
Ruft die Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetRouteUrl(Object) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(String, Object) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetUniqueIDRelativeTo(Control) |
Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control) |
| HasControls() |
Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Geerbt von Control) |
| HasEvents() |
Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden. (Geerbt von Control) |
| InitializeItem(DataGridItem, DataGridColumn[]) |
Initialisiert das angegebene DataGridItem-Objekt. |
| InitializePager(DataGridItem, Int32, PagedDataSource) |
Erstellt ein DataGridItem-Objekt, das die Pagingbenutzeroberfläche enthält. |
| IsLiteralContent() |
Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält. (Geerbt von Control) |
| LoadControlState(Object) |
Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden. (Geerbt von Control) |
| LoadViewState(Object) |
Lädt einen gespeicherten Zustand von DataGrid. |
| MapPathSecure(String) |
Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist. (Geerbt von Control) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| MergeStyle(Style) |
Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Bewegt das von einem Steuerelement im Container ausgelöste Ereignis in der Hierarchie der UI-Serversteuerelemente der Seite nach oben. |
| OnCancelCommand(DataGridCommandEventArgs) |
Löst das CancelCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen. |
| OnDataBinding(EventArgs) |
Löst das DataBinding-Ereignis eines BaseDataList-Steuerelements aus. (Geerbt von BaseDataList) |
| OnDataPropertyChanged() |
Wird aufgerufen, wenn eine der Identifikationseigenschaften der Basisdatenquelle geändert wird, um das datengebundene Steuerelement erneut an seine Daten zu binden. (Geerbt von BaseDataList) |
| OnDataSourceViewChanged(Object, EventArgs) |
Löst das DataSourceViewChanged-Ereignis aus. (Geerbt von BaseDataList) |
| OnDeleteCommand(DataGridCommandEventArgs) |
Löst das DeleteCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen. |
| OnEditCommand(DataGridCommandEventArgs) |
Löst das EditCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen. |
| OnInit(EventArgs) |
Löst das Init-Ereignis für das BaseDataList-Steuerelement aus. (Geerbt von BaseDataList) |
| OnItemCommand(DataGridCommandEventArgs) |
Löst das ItemCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen. |
| OnItemCreated(DataGridItemEventArgs) |
Löst das ItemCreated-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen. |
| OnItemDataBound(DataGridItemEventArgs) |
Löst das ItemDataBound-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen. |
| OnLoad(EventArgs) |
Löst das Load-Ereignis aus. (Geerbt von BaseDataList) |
| OnPageIndexChanged(DataGridPageChangedEventArgs) |
Löst das PageIndexChanged-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen. |
| OnPreRender(EventArgs) |
Löst das PreRender-Ereignis aus. (Geerbt von BaseDataList) |
| OnSelectedIndexChanged(EventArgs) |
Löst das SelectedIndexChanged-Ereignis eines BaseDataList-Steuerelements aus. (Geerbt von BaseDataList) |
| OnSortCommand(DataGridSortCommandEventArgs) |
Löst das SortCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen. |
| OnUnload(EventArgs) |
Löst das Unload-Ereignis aus. (Geerbt von Control) |
| OnUpdateCommand(DataGridCommandEventArgs) |
Löst das UpdateCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen. |
| OpenFile(String) |
Ruft einen Stream zum Lesen einer Datei ab. (Geerbt von Control) |
| PrepareControlHierarchy() |
Richtet die Steuerelementhierarchie für dieses DataGrid-Steuerelement ein. |
| RaiseBubbleEvent(Object, EventArgs) |
Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu. (Geerbt von Control) |
| RemovedControl(Control) |
Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde. (Geerbt von Control) |
| Render(HtmlTextWriter) |
Rendert das Steuerelement im angegebenen HTML-Writer. (Geerbt von BaseDataList) |
| RenderBeginTag(HtmlTextWriter) |
Gibt das öffnende HTML-Tag des Steuerelements im angegebenen Writer wieder. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| RenderChildren(HtmlTextWriter) |
Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den auf dem Client zu rendernden Inhalt schreibt. (Geerbt von Control) |
| RenderContents(HtmlTextWriter) |
Rendert den Inhalt des Steuerelements im angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| RenderControl(HtmlTextWriter) |
Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist. (Geerbt von Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus. (Geerbt von Control) |
| RenderEndTag(HtmlTextWriter) |
Stellt das schließende HTML-Tag des Steuerelements im angegebenen Writer dar. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| ResolveAdapter() |
Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Geerbt von Control) |
| ResolveClientUrl(String) |
Ruft eine URL ab, die vom Browser verwendet werden kann. (Geerbt von Control) |
| ResolveUrl(String) |
Konvertiert eine URL in eine vom anfordernden Client verwendbare URL. (Geerbt von Control) |
| SaveControlState() |
Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde. (Geerbt von Control) |
| SaveViewState() |
Speichert den aktuellen Zustand von DataGrid. |
| SetDesignModeState(IDictionary) |
Legt die Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control) |
| SetRenderMethodDelegate(RenderMethod) |
Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern. (Geerbt von Control) |
| SetTraceData(Object, Object) |
Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| SetTraceData(Object, Object, Object) |
Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TrackViewState() |
Markiert den Anfangspunkt, an dem mit dem Verfolgen und Speichern von Änderungen am Steuerelement im Rahmen des Ansichtszustands des Steuerelements begonnen wird. |
Ereignisse
| CancelCommand |
Tritt ein, wenn auf die Schaltfläche |
| DataBinding |
Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt. (Geerbt von Control) |
| DeleteCommand |
Tritt ein, wenn für ein Element im DataGrid-Steuerelement auf die Schaltfläche Löschen geklickt wird. |
| Disposed |
Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite. (Geerbt von Control) |
| EditCommand |
Tritt ein, wenn für ein Element im DataGrid-Steuerelement auf die Schaltfläche Bearbeiten geklickt wird. |
| Init |
Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus. (Geerbt von Control) |
| ItemCommand |
Tritt ein, wenn auf eine beliebige Schaltfläche im DataGrid-Steuerelement geklickt wird. |
| ItemCreated |
Tritt auf dem Server ein, wenn im DataGrid-Steuerelement ein Element erstellt wird. |
| ItemDataBound |
Tritt ein, nachdem ein Element an das DataGrid-Steuerelement datengebunden wurde. |
| Load |
Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird. (Geerbt von Control) |
| PageIndexChanged |
Tritt ein, wenn auf eines der Seitenauswahlelemente geklickt wird. |
| PreRender |
Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein. (Geerbt von Control) |
| SelectedIndexChanged |
Tritt ein, wenn in einem Datenauflistungssteuerelement zwischen Übermittlungen zum Server ein anderes Element ausgewählt wird. (Geerbt von BaseDataList) |
| SortCommand |
Tritt beim Sortieren einer Spalte ein. |
| Unload |
Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird. (Geerbt von Control) |
| UpdateCommand |
Tritt ein, wenn auf die Schaltfläche Update für ein Element im DataGrid-Steuerelement geklickt wird. |
Explizite Schnittstellenimplementierungen
| IAttributeAccessor.GetAttribute(String) |
Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab. (Geerbt von WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Legt zum angegebenen Namen und Wert ein Attribut des Websteuerelements fest. (Geerbt von WebControl) |
| IControlBuilderAccessor.ControlBuilder |
Eine Beschreibung dieses Elements finden Sie unter ControlBuilder. (Geerbt von Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Eine Beschreibung dieses Elements finden Sie unter GetDesignModeState(). (Geerbt von Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Eine Beschreibung dieses Elements finden Sie unter SetDesignModeState(IDictionary). (Geerbt von Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Eine Beschreibung dieses Elements finden Sie unter SetOwnerControl(Control). (Geerbt von Control) |
| IControlDesignerAccessor.UserData |
Eine Beschreibung dieses Elements finden Sie unter UserData. (Geerbt von Control) |
| IDataBindingsAccessor.DataBindings |
Eine Beschreibung dieses Elements finden Sie unter DataBindings. (Geerbt von Control) |
| IDataBindingsAccessor.HasDataBindings |
Eine Beschreibung dieses Elements finden Sie unter HasDataBindings. (Geerbt von Control) |
| IExpressionsAccessor.Expressions |
Eine Beschreibung dieses Elements finden Sie unter Expressions. (Geerbt von Control) |
| IExpressionsAccessor.HasExpressions |
Eine Beschreibung dieses Elements finden Sie unter HasExpressions. (Geerbt von Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object). (Geerbt von Control) |
Erweiterungsmethoden
| FindDataSourceControl(Control) |
Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist. |
| FindFieldTemplate(Control, String) |
Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück. |
| FindMetaTable(Control) |
Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück. |
| GetDefaultValues(INamingContainer) |
Ruft die Auflistung der Standardwerte für das angegebene Datensteuerelement ab. |
| GetMetaTable(INamingContainer) |
Ruft die Tabellenmetadaten für das angegebene Datensteuerelement ab. |
| SetMetaTable(INamingContainer, MetaTable) |
Legt die Tabellenmetadaten für das angegebene Datensteuerelement fest. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Bestimmt, ob Tabellenmetadaten verfügbar sind. |
| EnableDynamicData(INamingContainer, Type) |
Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement |
| EnableDynamicData(INamingContainer, Type, Object) |
Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement |
Gilt für:
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für