DataGrid Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Элемент управления "Список" с привязкой к данным, который отображает в таблице элементы из источника данных. Элемент управления DataGrid, позволяющий выбрать, сортировать и изменять эти элементы.
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- Наследование
- Реализации
Примеры
В следующем примере кода показано, как использовать DataGrid элемент управления для отображения элементов в источнике данных.
<%@ 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>
В следующем примере кода показано, как использовать DataGrid элемент управления для простой корзины для покупок.
<%@ 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>
В следующем примере кода показано, как динамически добавлять атрибуты в <td> теги и <tr> , созданные элементом DataGrid управления .
<%@ 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>
Комментарии
В этом разделе:
Введение
DataGrid Используйте элемент управления для отображения полей источника данных в виде столбцов в таблице. Каждая строка в элементе DataGrid управления представляет запись в источнике данных. Элемент DataGrid управления поддерживает выделение, редактирование, удаление, разбиение на страницы и сортировку.
Внимание!
Этот элемент управления можно использовать для отображения введенных пользователем данных, которые могут включать вредоносный клиентский скрипт. Перед отображением в приложении проверьте все сведения, отправляемые клиентом для исполняемого скрипта, инструкций SQL или другого кода. ASP.NET предоставляет функцию проверки входных запросов для блокировки скриптов и HTML во входных данных пользователя. Серверные элементы управления проверки также предоставляются для оценки введенных пользователем данных. Дополнительные сведения см. в разделе Синтаксис серверного элемента управления Проверки.
Различные типы столбцов определяют поведение столбцов в элементе управления . В следующей таблице перечислены различные типы столбцов, которые можно использовать.
| Тип столбца | Описание |
|---|---|
| BoundColumn | Отображает столбец, привязанный к полю в источнике данных. Каждый элемент в поле отображается в виде текста. Это тип столбца по умолчанию для DataGrid элемента управления . |
| ButtonColumn | Отображает командную кнопку для каждого элемента в столбце. Это позволяет создать столбец настраиваемых элементов управления кнопками, таких как Add или Remove . |
| EditCommandColumn | Отображает столбец, содержащий команды редактирования для каждого элемента в столбце. |
| HyperLinkColumn | Отображает содержимое каждого элемента в столбце в виде гиперссылки. Содержимое столбца может быть привязано к полю в источнике данных или к статическому тексту. |
| TemplateColumn | Отображает каждый элемент в столбце, следующем за указанным шаблоном. Это позволяет предоставлять пользовательские элементы управления в столбце. |
По умолчанию свойству AutoGenerateColumns присваивается значение true, которое создает BoundColumn объект для каждого поля в источнике данных. Затем каждое поле отображается в виде столбца в элементе DataGrid управления в том порядке, в который каждое поле отображается в источнике данных.
Вы также можете вручную указать, какие столбцы будут отображаться в DataGrid элементе управления, задав AutoGenerateColumns для свойства значение false , а затем перечислив столбцы, которые необходимо включить между открывающим и закрывающим <Columns> тегами. Указанные столбцы добавляются в коллекцию Columns в указанном порядке. Это позволяет программно управлять столбцами в элементе DataGrid управления .
Примечание
Порядок отображения столбцов в элементе DataGrid управления определяется порядком отображения столбцов в Columns коллекции. Хотя вы можете программно изменить порядок столбцов, управляя Columns коллекцией, проще перечислить столбцы в нужном порядке отображения.
Явно объявленные столбцы могут отображаться в сочетании с автоматически созданными столбцами. При использовании обоих явно объявленных столбцов сначала отрисовывается, а затем автоматически создаваемые столбцы.
Примечание
Автоматически созданные столбцы не добавляются в коллекцию Columns .
Внешний DataGrid вид элемента управления можно настроить, задав свойства стиля для различных частей элемента управления. В следующей таблице перечислены различные свойства стиля.
| Свойство Style | Описание |
|---|---|
| AlternatingItemStyle | Задает стиль чередования элементов в элементе DataGrid управления . |
| EditItemStyle | Задает стиль редактируемого элемента в элементе DataGrid управления . |
| FooterStyle | Задает стиль раздела нижнего колонтитула в элементе DataGrid управления . |
| HeaderStyle | Задает стиль раздела заголовка в элементе DataGrid управления . |
| ItemStyle | Задает стиль элементов в элементе DataGrid управления . |
| PagerStyle | Задает стиль для раздела выбора страницы DataGrid элемента управления . |
| SelectedItemStyle | Задает стиль для выбранного элемента в элементе DataGrid управления . |
Вы также можете отображать или скрывать различные части элемента управления. В следующей таблице перечислены свойства, определяющие, какие части отображаются или скрыты.
| Свойство | Описание |
|---|---|
| ShowFooter | Отображает или скрывает раздел нижнего DataGrid колонтитула элемента управления. |
| ShowHeader | Отображает или скрывает раздел заголовка DataGrid элемента управления . |
Внешний вид DataGrid элемента управления можно управлять программными средствами, добавляя атрибуты к тегам <td> и <tr> , отображаемым элементом управления в браузере. Атрибуты можно добавить программным способом, предоставив код в обработчике событий для OnItemCreated события или OnItemDataBound .
Чтобы добавить атрибут к тегу <td> , сначала получите TableCell объект , представляющий ячейку в элементе DataGrid управления, в который вы хотите добавить атрибут. Для Control.Controls получения нужного ItemDataGridItemEventArgsTableCell объекта можно использовать коллекцию для свойства объекта , переданного в обработчик событий. Затем можно использовать AttributeCollection.Add метод Attributes коллекции для объекта , TableCell чтобы добавить атрибуты в <td> тег .
Чтобы добавить атрибут к тегу <tr> , сначала получите DataGridItem объект , представляющий строку в элементе DataGrid управления, в который требуется добавить атрибут. Свойство Item объекта , DataGridItemEventArgs переданное в обработчик событий, можно использовать для получения нужного DataGridItem объекта. Затем можно использовать AttributeCollection.Add метод Attributes коллекции для объекта , DataGridItem чтобы добавить атрибуты в <tr> тег .
Специальные возможности
Сведения о том, как настроить этот элемент управления таким образом, чтобы он создавал разметку, соответствующую стандартам специальных возможностей, см. в разделах Специальные возможности в Visual Studio и ASP.NET и ASP.NET Controls and Accessibility.
Декларативный синтаксис
<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>
Конструкторы
| DataGrid() |
Инициализирует новый экземпляр класса DataGrid. |
Поля
| CancelCommandName |
Представляет имя команды |
| DeleteCommandName |
Представляет имя команды "Удалить". Это поле доступно только для чтения. |
| EditCommandName |
Представляет имя команды "Править". Это поле доступно только для чтения. |
| NextPageCommandArgument |
Представляет аргумент команды "След.". Это поле доступно только для чтения. |
| PageCommandName |
Представляет имя команды "Страница". Это поле доступно только для чтения. |
| PrevPageCommandArgument |
Представляет аргумент команды "Пред.". Это поле доступно только для чтения. |
| SelectCommandName |
Представляет имя команды "Выбрать". Это поле доступно только для чтения. |
| SortCommandName |
Представляет имя команды "Сортировать". Это поле доступно только для чтения. |
| UpdateCommandName |
Представляет имя команды "Обновить". Это поле доступно только для чтения. |
Свойства
| AccessKey |
Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления. (Унаследовано от WebControl) |
| Adapter |
Возвращает конкретный адаптер браузера для элемента управления. (Унаследовано от Control) |
| AllowCustomPaging |
Получает или задает значение, определяющее, включено ли пользовательское разбиение по страницам. |
| AllowPaging |
Получает или задает значение, определяющее, включено ли разбиение по страницам. |
| AllowSorting |
Получает или задает значение, определяющее, включена ли сортировка. |
| AlternatingItemStyle |
Возвращает свойства стиля изменяемых записей элемента управления DataGrid. |
| AppRelativeTemplateSourceDirectory |
Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления. (Унаследовано от Control) |
| Attributes |
Получает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления. (Унаследовано от WebControl) |
| AutoGenerateColumns |
Получает или задает значение, показывающее, создаются ли объекты BoundColumn автоматически и отображаются ли они в элементе управления DataGrid для каждого поля в источнике данных. |
| BackColor |
Получает или задает цвет фона серверного веб-элемента управления. (Унаследовано от WebControl) |
| BackImageUrl |
Получает или задает URL-адрес изображения, отображаемого как фон элемента управления DataGrid. |
| BindingContainer |
Возвращает элемент управления, который содержит привязку данных элемента управления. (Унаследовано от Control) |
| BorderColor |
Возвращает или задает цвет рамки элемента управления Веба. (Унаследовано от WebControl) |
| BorderStyle |
Получает или задает стиль границы серверного веб-элемента управления. (Унаследовано от WebControl) |
| BorderWidth |
Возвращает или задает ширину границы серверного веб-элемента управления. (Унаследовано от WebControl) |
| Caption |
Получает или задает текст для отображения в HTML-элементе заголовка элемента управления. Данное свойство позволяет сделать элемент управления более доступным для пользователей вспомогательных устройств. (Унаследовано от BaseDataList) |
| CaptionAlign |
Получает или задает горизонтальное или вертикальное расположение HTML-элемента заголовка в элементе управления. Данное свойство позволяет сделать элемент управления более доступным для пользователей вспомогательных устройств. (Унаследовано от BaseDataList) |
| CellPadding |
Получает или задает расстояние между содержимым ячейки и ее границей. (Унаследовано от BaseDataList) |
| CellSpacing |
Возвращает или задает расстояние между ячейками. (Унаследовано от BaseDataList) |
| ChildControlsCreated |
Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления. (Унаследовано от Control) |
| ClientID |
Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET. (Унаследовано от Control) |
| ClientIDMode |
Возвращает или задает алгоритм, используемый для создания значения свойства ClientID. (Унаследовано от Control) |
| ClientIDSeparator |
Возвращает значение символа разделителя, используемого в свойстве ClientID. (Унаследовано от Control) |
| Columns |
Возвращает коллекцию объектов, представляющих столбцы элемента управления DataGrid. |
| Context |
Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control) |
| Controls |
Возвращает объект ControlCollection, содержащий коллекцию дочерних элементов управления элемента управления списка данных. (Унаследовано от BaseDataList) |
| ControlStyle |
Возвращает или задает стиль серверного веб-элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl) |
| ControlStyleCreated |
Возвращает значение, определяющее, был ли объект Style создан для свойства ControlStyle. Этот свойство в основном используется разработчиками элементов управления. (Унаследовано от WebControl) |
| CssClass |
Возвращает или задает класс каскадных листов стилей (CSS), преобразовываемый для просмотра в серверном веб-элементе управления на клиентском компьютере. (Унаследовано от WebControl) |
| CurrentPageIndex |
Получает или задает индекс отображаемой в настоящее время страницы. |
| DataItemContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataItemContainer. (Унаследовано от Control) |
| DataKeyField |
Получает или задает ключевое поле источника данных, указанного в свойстве DataSource. (Унаследовано от BaseDataList) |
| DataKeys |
Возвращает объект DataKeyCollection, содержащий значения ключей каждой записи элемента управления списка данных. (Унаследовано от BaseDataList) |
| DataKeysArray |
Возвращает объект ArrayList, содержащий значения ключей каждой записи элемента управления списка данных. (Унаследовано от BaseDataList) |
| DataKeysContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataKeysControl. (Унаследовано от Control) |
| DataMember |
Получает или задает отдельный элемент данных источника данных, содержащего несколько элементов, для привязки к элементу управления списка данных. (Унаследовано от BaseDataList) |
| DataSource |
Получает или задает источник, содержащий список значений, используемых для заполнения элементов в элементе управления. (Унаследовано от BaseDataList) |
| DataSourceID |
Получает или задает свойство ID элемента управления источника данных, который должен использоваться элементом управления источника данных для извлечения своего источника данных. (Унаследовано от BaseDataList) |
| DesignMode |
Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки. (Унаследовано от Control) |
| EditItemIndex |
Получает или задает индекс редактируемой записи в элементе управления DataGrid. |
| EditItemStyle |
Возвращает свойства стиля для записи, выбранной для редактирования в элементе управления DataGrid. |
| Enabled |
Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления. (Унаследовано от WebControl) |
| EnableTheming |
Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления. (Унаследовано от WebControl) |
| EnableViewState |
Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления. (Унаследовано от Control) |
| Events |
Возвращает список делегатов обработчиков событий элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control) |
| Font |
Возвращает свойства шрифта, связанные с серверным веб-элементом управления. (Унаследовано от WebControl) |
| FooterStyle |
Возвращает свойства стиля для раздела нижнего колонтитула элемента управления DataGrid. |
| ForeColor |
Возвращает или задает основной цвет (обычно это цвет текста) для серверного веб-элемента управления. (Унаследовано от WebControl) |
| GridLines |
Получает или задает значение, указывающее, отображается ли граница между ячейками элемента управления списка данных. (Унаследовано от BaseDataList) |
| HasAttributes |
Получает значение, определяющие наличие атрибутов у элемента управления. (Унаследовано от WebControl) |
| HasChildViewState |
Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления. (Унаследовано от Control) |
| HeaderStyle |
Возвращает свойства стиля для раздела заголовка элемента управления DataGrid. |
| Height |
Получает или задает высоту серверного веб-элемента управления. (Унаследовано от WebControl) |
| HorizontalAlign |
Получает или задает горизонтальное выравнивание элемента управления списка данных в пределах контейнера. (Унаследовано от BaseDataList) |
| ID |
Возвращает или задает программный идентификатор, назначенный серверному элементу управления. (Унаследовано от Control) |
| IdSeparator |
Возвращает символ, используемый для разделения идентификаторов элементов управления. (Унаследовано от Control) |
| Initialized |
Возвращает значение, указывающее, был ли инициализирован элемент управления. (Унаследовано от BaseDataList) |
| IsBoundUsingDataSourceID |
Получает значение, указывающее, установлено ли свойство DataSourceID. (Унаследовано от BaseDataList) |
| IsChildControlStateCleared |
Возвращает значение, указывающее, имеют ли элементы управления в этом элементе управления состояние элемента управления. (Унаследовано от Control) |
| IsEnabled |
Возвращает значение, определяющее, включен ли элемент управления. (Унаследовано от WebControl) |
| IsTrackingViewState |
Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления. (Унаследовано от Control) |
| IsViewStateEnabled |
Возвращает значение, указывающее, используется ли состояние представления для этого элемента управления. (Унаследовано от Control) |
| Items |
Возвращает коллекцию объектов DataGridItem, представляющих отдельные записи в элементе управления DataGrid. |
| ItemStyle |
Возвращает свойства стиля для записей в элементе управления DataGrid. |
| LoadViewStateByID |
Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса. (Унаследовано от Control) |
| NamingContainer |
Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства ID. (Унаследовано от Control) |
| Page |
Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления. (Унаследовано от Control) |
| PageCount |
Возвращает общее число страниц, необходимых для отображения записей в элементе управления DataGrid. |
| PagerStyle |
Возвращает свойства стиля для раздела разбиения по страницам в элементе управления DataGrid. |
| PageSize |
Получает или задает число записей, отображаемых на одной странице элемента управления DataGrid. |
| Parent |
Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы. (Унаследовано от Control) |
| RenderingCompatibility |
Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML. (Унаследовано от Control) |
| RequiresDataBinding |
Получает или задает значение, указывающее, нужно ли привязывать элемент управления списка данных к указанному для него источнику данных. (Унаследовано от BaseDataList) |
| SelectArguments |
Возвращает объект DataSourceSelectArguments, который используется элементом управления с привязкой к данным при извлечении данных из элемента управления источником данных. (Унаследовано от BaseDataList) |
| SelectedIndex |
Получает или задает индекс выбранного элемента в элементе управления DataGrid. |
| SelectedItem |
Возвращает объект DataGridItem, представляющий выделенную запись в элементе управления DataGrid. |
| SelectedItemStyle |
Возвращает свойства стиля для выделенной в данный момент записи в элементе управления DataGrid. |
| ShowFooter |
Получает или задает значение, показывающее, отображается ли нижний колонтитул в элементе управления DataGrid. |
| ShowHeader |
Получает или задает значение, показывающее, отображается ли верхний колонтитул в элементе управления DataGrid. |
| Site |
Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора. (Унаследовано от Control) |
| SkinID |
Возвращает или задает обложку, применяемую к элементу управления. (Унаследовано от WebControl) |
| Style |
Возвращает коллекцию атрибутов текста, которые будут отображены в виде атрибута стиля на внешнем теге серверного веб-элемента управления. (Унаследовано от WebControl) |
| SupportsDisabledAttribute |
Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута |
| TabIndex |
Возвращает или задает индекс перехода по клавише Tab для серверного веб-элемента управления. (Унаследовано от WebControl) |
| TagKey |
Получает значение HtmlTextWriterTag для элемента управления DataGrid. |
| TagKey |
Возвращает значение HtmlTextWriterTag, которое соответствует этому элементу управления веб-сервера. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl) |
| TagName |
Возвращает имя тега элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl) |
| TemplateControl |
Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control) |
| TemplateSourceDirectory |
Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления. (Унаследовано от Control) |
| ToolTip |
Возвращает или задает текст, который отображается при наведении указателя мыши на серверный веб-элемент управления. (Унаследовано от WebControl) |
| UniqueID |
Возвращает уникальный идентификатор серверного элемента управления в иерархии. (Унаследовано от Control) |
| UseAccessibleHeader |
Получает или задает значение, указывающее, преобразуется ли заголовок элемента управления списка данных в доступный для просмотра формат. Данное свойство позволяет сделать элемент управления более доступным для пользователей вспомогательных устройств. (Унаследовано от BaseDataList) |
| ValidateRequestMode |
Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений. (Унаследовано от Control) |
| ViewState |
Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы. (Унаследовано от Control) |
| ViewStateIgnoresCase |
Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру. (Унаследовано от Control) |
| ViewStateMode |
Возвращает или задает режим состояния представления данного элемента управления. (Унаследовано от Control) |
| VirtualItemCount |
Получает или задает виртуальное число записей в элементе управления DataGrid при использовании пользовательского разбиения по страницам. |
| Visible |
Получает или задает значение, указывающее, отрисовывается ли серверный элемент управления как пользовательский интерфейс на странице. (Унаследовано от Control) |
| Width |
Получает или задает ширину серверного веб-элемента управления. (Унаследовано от WebControl) |
Методы
| AddAttributesToRender(HtmlTextWriter) |
Добавляет атрибуты и стили HTML, которые должны быть отображены в указанном элементе управления HtmlTextWriterTag. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| AddedControl(Control, Int32) |
Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control. (Унаследовано от Control) |
| AddParsedSubObject(Object) |
Сообщает серверному элементу управления о том, что XML- или HTML-элемент был проанализирован, и добавляет элемент в коллекцию ControlCollection серверного элемента управления. (Унаследовано от BaseDataList) |
| ApplyStyle(Style) |
Копирует любой непустой элемент указанного стиля в элемент управления Веба, перезаписывая уже существующие элементы стиля. Этот метод, в основном, используется разработчиками элементов управления. (Унаследовано от WebControl) |
| ApplyStyleSheetSkin(Page) |
Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control) |
| BeginRenderTracing(TextWriter, Object) |
Запускает трассировку во время разработки данных отрисовки. (Унаследовано от Control) |
| BuildProfileTree(String, Boolean) |
Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке. (Унаследовано от Control) |
| ClearCachedClientID() |
Задает для кэшированного свойства ClientID значение |
| ClearChildControlState() |
Удаляет сведения о состоянии элемента управления для дочерних элементов управления серверного элемента управления. (Унаследовано от Control) |
| ClearChildState() |
Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control) |
| ClearChildViewState() |
Удаляет сведения о состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control) |
| ClearEffectiveClientIDMode() |
Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit. (Унаследовано от Control) |
| CopyBaseAttributes(WebControl) |
Копирует не инкапсулированные объектом Style свойства из указанного серверного веб-элемента управления веб-сервера в элемент управления веб-сервера, откуда вызывается этот метод. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| CreateChildControls() |
Создает дочерний элемент управления, используя состояние просмотра. (Унаследовано от BaseDataList) |
| CreateColumnSet(PagedDataSource, Boolean) |
Создает набор столбцов, реализующихся для построения иерархии элементов управления. Если AutoGenerateColumns истинно, создаются столбцы, соответствующие источнику данных, которые далее добавляются к набору столбцов в коллекции Columns. |
| CreateControlCollection() |
Создает новый объект ControlCollection для хранения дочерних элементов управления (литеральных и серверных) серверного элемента управления. (Унаследовано от Control) |
| CreateControlHierarchy(Boolean) |
Создает иерархию элементов управления для обработки DataGrid. |
| CreateControlStyle() |
Создает новый стиль элемента управления. |
| CreateDataSourceSelectArguments() |
Создает используемый по умолчанию объект DataSourceSelectArguments, применяемый элементом управления с привязкой к данным, если не заданы аргументы. (Унаследовано от BaseDataList) |
| CreateItem(Int32, Int32, ListItemType) |
Создает объект DataGridItem. |
| DataBind() |
Привязывает элемент управления и все его дочерние элементы управления к указанному источнику данных. (Унаследовано от BaseDataList) |
| DataBind(Boolean) |
Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding. (Унаследовано от Control) |
| DataBindChildren() |
Привязывает источник данных к дочерним элементам управления серверного элемента управления. (Унаследовано от Control) |
| Dispose() |
Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти. (Унаследовано от Control) |
| EndRenderTracing(TextWriter, Object) |
Завершает трассировку во время разработки данных отрисовки. (Унаследовано от Control) |
| EnsureChildControls() |
Определяет наличие у серверного элемента управления дочерних элементов управления. Если дочерних элементов управления нет, они будут созданы. (Унаследовано от Control) |
| EnsureDataBound() |
Вызывает метод DataBind() после того, как проверит, что для элемента управления списка данных нужна привязка данных и что задан допустимый элемент управления источником данных. (Унаследовано от BaseDataList) |
| EnsureID() |
Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора. (Унаследовано от Control) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| FindControl(String) |
Выполняет поиск серверного элемента управления с заданным параметром |
| FindControl(String, Int32) |
Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным |
| Focus() |
Задает фокус ввода на элемент управления. (Унаследовано от Control) |
| GetData() |
Возвращает объект, реализующий интерфейс IEnumerable и представляющий источник данных. (Унаследовано от BaseDataList) |
| GetDesignModeState() |
Возвращает данные времени разработки для элемента управления. (Унаследовано от Control) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetRouteUrl(Object) |
Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control) |
| GetRouteUrl(RouteValueDictionary) |
Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control) |
| GetRouteUrl(String, Object) |
Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control) |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| GetUniqueIDRelativeTo(Control) |
Возвращает часть с префиксом свойства UniqueID указанного элемента управления. (Унаследовано от Control) |
| HasControls() |
Определяет наличие у серверного элемента управления дочерних элементов управления. (Унаследовано от Control) |
| HasEvents() |
Возвращает значение, указывающее, регистрируются ли события для элемента управления или каких-либо дочерних элементов управления. (Унаследовано от Control) |
| InitializeItem(DataGridItem, DataGridColumn[]) |
Инициализирует указанный объект DataGridItem. |
| InitializePager(DataGridItem, Int32, PagedDataSource) |
Создает объект DataGridItem, содержащий интерфейс разбиения по страницам. |
| IsLiteralContent() |
Определяет наличие у серверного элемента управления только текстового содержимого. (Унаследовано от Control) |
| LoadControlState(Object) |
Восстанавливает сведения о состоянии элемента управления предыдущего запроса страницы, сохраненные методом SaveControlState(). (Унаследовано от Control) |
| LoadViewState(Object) |
Загружает сохраненное ранее состояние DataGrid. |
| MapPathSecure(String) |
Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный). (Унаследовано от Control) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| MergeStyle(Style) |
Копирует любой непустой элемент указанного стиля в элемент управления Веба, но не перезаписывает уже существующие элементы стиля. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Передает событие элемента управления в контейнере, вверх в иерархии серверных элементов управления пользовательского интерфейса страницы. |
| OnCancelCommand(DataGridCommandEventArgs) |
Вызывает событие CancelCommand. Это позволяет предоставить настраиваемый обработчик для события. |
| OnDataBinding(EventArgs) |
Вызывает событие DataBinding элемента управления BaseDataList. (Унаследовано от BaseDataList) |
| OnDataPropertyChanged() |
Вызывается при изменении одного из свойств определения базового источника данных, чтобы повторно привязать элемент управления с привязкой к его данным. (Унаследовано от BaseDataList) |
| OnDataSourceViewChanged(Object, EventArgs) |
Вызывает событие DataSourceViewChanged. (Унаследовано от BaseDataList) |
| OnDeleteCommand(DataGridCommandEventArgs) |
Вызывает событие DeleteCommand. Это позволяет предоставить настраиваемый обработчик для события. |
| OnEditCommand(DataGridCommandEventArgs) |
Вызывает событие EditCommand. Это позволяет предоставить настраиваемый обработчик для события. |
| OnInit(EventArgs) |
Создает событие Init элемента управления BaseDataList. (Унаследовано от BaseDataList) |
| OnItemCommand(DataGridCommandEventArgs) |
Вызывает событие ItemCommand. Это позволяет предоставить настраиваемый обработчик для события. |
| OnItemCreated(DataGridItemEventArgs) |
Вызывает событие ItemCreated. Это позволяет предоставить настраиваемый обработчик для события. |
| OnItemDataBound(DataGridItemEventArgs) |
Вызывает событие ItemDataBound. Это позволяет предоставить настраиваемый обработчик для события. |
| OnLoad(EventArgs) |
Вызывает событие Load. (Унаследовано от BaseDataList) |
| OnPageIndexChanged(DataGridPageChangedEventArgs) |
Вызывает событие PageIndexChanged. Это позволяет предоставить настраиваемый обработчик для события. |
| OnPreRender(EventArgs) |
Вызывает событие PreRender. (Унаследовано от BaseDataList) |
| OnSelectedIndexChanged(EventArgs) |
Вызывает событие SelectedIndexChanged элемента управления BaseDataList. (Унаследовано от BaseDataList) |
| OnSortCommand(DataGridSortCommandEventArgs) |
Вызывает событие SortCommand. Это позволяет предоставить настраиваемый обработчик для события. |
| OnUnload(EventArgs) |
Вызывает событие Unload. (Унаследовано от Control) |
| OnUpdateCommand(DataGridCommandEventArgs) |
Вызывает событие UpdateCommand. Это позволяет предоставить настраиваемый обработчик для события. |
| OpenFile(String) |
Возвращает Stream, используемое для чтения файла. (Унаследовано от Control) |
| PrepareControlHierarchy() |
Настраивает иерархию элементов управления для элемента управления DataGrid. |
| RaiseBubbleEvent(Object, EventArgs) |
Присваивает родительскому элементу управления все источники события и сведения о них. (Унаследовано от Control) |
| RemovedControl(Control) |
Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
Выполняет визуализацию элемента управления в указанный модуль записи HTML. (Унаследовано от BaseDataList) |
| RenderBeginTag(HtmlTextWriter) |
Выводит открывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает это содержимое для подготовки к просмотру на клиенте. (Унаследовано от Control) |
| RenderContents(HtmlTextWriter) |
Выводит содержимое элемента управления в заданный модуль записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| RenderControl(HtmlTextWriter) |
Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter. (Унаследовано от Control) |
| RenderEndTag(HtmlTextWriter) |
Отображает закрывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| ResolveAdapter() |
Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления. (Унаследовано от Control) |
| ResolveClientUrl(String) |
Возвращает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
| ResolveUrl(String) |
Преобразует URL-адрес в адрес, доступный для клиента. (Унаследовано от Control) |
| SaveControlState() |
Сохраняет любые изменения состояния серверного элемента управления, произошедшие после отправки страницы обратно на сервер. (Унаследовано от Control) |
| SaveViewState() |
Сохраняет текущее состояние класса DataGrid. |
| SetDesignModeState(IDictionary) |
Задает данные времени разработки для элемента управления. (Унаследовано от Control) |
| SetRenderMethodDelegate(RenderMethod) |
Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления. (Унаследовано от Control) |
| SetTraceData(Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| TrackViewState() |
Отмечает начальный пункт для начала отслеживания и сохранения изменений в элементе управления как части режима отображения элемента управления. |
События
| CancelCommand |
Происходит при нажатии кнопки |
| DataBinding |
Происходит при привязке серверного элемента управления к источнику данных. (Унаследовано от Control) |
| DeleteCommand |
Происходит при нажатии кнопки "Удалить" для записи в элементе управления DataGrid. |
| Disposed |
Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET. (Унаследовано от Control) |
| EditCommand |
Происходит при нажатии кнопки "Править" для записи в элементе управления DataGrid. |
| Init |
Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла. (Унаследовано от Control) |
| ItemCommand |
Происходит при нажатии любой кнопки в элементе управления DataGrid. |
| ItemCreated |
Происходит на сервере при создании записи в элементе управления DataGrid. |
| ItemDataBound |
Происходит после привязки данных записи к элементу управления DataGrid. |
| Load |
Происходит при загрузке серверного элемента управления в объект Page. (Унаследовано от Control) |
| PageIndexChanged |
Происходит при нажатии одного из элементов выбора страниц. |
| PreRender |
Происходит после загрузки объекта Control, но перед отрисовкой. (Унаследовано от Control) |
| SelectedIndexChanged |
Происходит при выделении различных элементов в элементе управления списка данных между отправками к серверу. (Унаследовано от BaseDataList) |
| SortCommand |
Происходит при сортировке столбца. |
| Unload |
Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control) |
| UpdateCommand |
Происходит при нажатии кнопки "Обновить" для записи в элементе управления DataGrid. |
Явные реализации интерфейса
Методы расширения
| FindDataSourceControl(Control) |
Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления. |
| FindFieldTemplate(Control, String) |
Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления. |
| FindMetaTable(Control) |
Возвращает объект метатаблицы для контейнерного элемента управления данными. |
| GetDefaultValues(INamingContainer) |
Получает коллекцию значений по умолчанию для заданного элемента управления данными. |
| GetMetaTable(INamingContainer) |
Получает метаданные таблицы для заданного элемента управления данными. |
| SetMetaTable(INamingContainer, MetaTable) |
Задает метаданные таблицы для заданного элемента управления данными. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Определяет, доступны ли метаданные таблицы. |
| EnableDynamicData(INamingContainer, Type) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |
| EnableDynamicData(INamingContainer, Type, Object) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |
Применяется к
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по