DataGrid Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Ovládací prvek seznamu vázaného na data, který zobrazuje položky ze zdroje dat v tabulce. Ovládací DataGrid prvek umožňuje vybrat, seřadit a upravit tyto položky.
public ref class DataGrid : System::Web::UI::WebControls::BaseDataList, System::Web::UI::INamingContainer
public class DataGrid : System.Web.UI.WebControls.BaseDataList, System.Web.UI.INamingContainer
type DataGrid = class
inherit BaseDataList
interface INamingContainer
Public Class DataGrid
Inherits BaseDataList
Implements INamingContainer
- Dědičnost
- Implementuje
Příklady
Následující příklad kódu ukazuje, jak pomocí DataGrid ovládacího prvku zobrazit položky ve zdroji dat.
<%@ 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>
Následující příklad kódu ukazuje, jak použít DataGrid ovládací prvek pro jednoduchý nákupní košík.
<%@ 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>
Následující příklad kódu ukazuje, jak dynamicky přidávat atributy do <td>
značek a <tr>
vygenerovaných ovládacím DataGrid prvku.
<%@ 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>
Poznámky
V tomto tématu:
Úvod
DataGrid Pomocí ovládacího prvku můžete zobrazit pole zdroje dat jako sloupce v tabulce. Každý řádek v ovládacím DataGrid prvku představuje záznam ve zdroji dat. Ovládací DataGrid prvek podporuje výběr, úpravy, odstraňování, stránkování a řazení.
Upozornění
Tento ovládací prvek lze použít k zobrazení vstupu uživatele, který může zahrnovat škodlivý klientský skript. Než ho zobrazíte v aplikaci, zkontrolujte všechny informace odesílané klientem kvůli spustitelnému skriptu, příkazům SQL nebo jinému kódu. ASP.NET poskytuje funkci ověření vstupní žádosti, která blokuje skript a html v uživatelském vstupu. K dispozici jsou také ovládací prvky ověřovacího serveru pro posouzení vstupu uživatele. Další informace najdete v tématu Syntaxe ovládacího prvku ověřovacího serveru.
Různé typy sloupců určují chování sloupců v ovládacím prvku. Následující tabulka uvádí různé typy sloupců, které se dají použít.
Typ sloupce | Description |
---|---|
BoundColumn | Zobrazí sloupec vázaný na pole ve zdroji dat. Zobrazí každou položku v poli jako text. Toto je výchozí typ DataGrid sloupce ovládacího prvku. |
ButtonColumn | Zobrazí příkazové tlačítko pro každou položku ve sloupci. To vám umožní vytvořit sloupec s vlastními ovládacími prvky tlačítek, jako Add jsou tlačítka nebo Remove . |
EditCommandColumn | Zobrazí sloupec, který obsahuje příkazy pro úpravy pro každou položku ve sloupci. |
HyperLinkColumn | Zobrazí obsah každé položky ve sloupci jako hypertextový odkaz. Obsah sloupce může být svázán s polem ve zdroji dat nebo statickým textem. |
TemplateColumn | Zobrazí každou položku ve sloupci za zadanou šablonou. To vám umožní zadat vlastní ovládací prvky ve sloupci. |
Ve výchozím nastavení AutoGenerateColumns je vlastnost nastavena na true
hodnotu , která vytvoří BoundColumn objekt pro každé pole ve zdroji dat. Každé pole se pak v ovládacím prvku vykreslí jako sloupec DataGrid v pořadí, v jakém se jednotlivá pole zobrazují ve zdroji dat.
Můžete také ručně určit, které sloupce se zobrazí v DataGrid ovládacím prvku, nastavením AutoGenerateColumns vlastnosti na false
a následným výpisem sloupců, které chcete zahrnout mezi počáteční a uzavírací <Columns>
značky. Zadané sloupce se přidají do Columns kolekce v uvedeném pořadí. To vám umožní řídit sloupce v ovládacím DataGrid prvku prostřednictvím kódu programu.
Poznámka
Pořadí zobrazení sloupců v ovládacím DataGrid prvku je řízeno pořadím, ve kterém se sloupce zobrazují v kolekci Columns . I když můžete programově změnit pořadí sloupců manipulací s kolekcí Columns , je jednodušší vypsat sloupce v požadovaném pořadí zobrazení.
Explicitně deklarované sloupce je možné zobrazit ve spojení s automaticky vygenerovanými sloupci. Při použití obou se nejprve vykreslí explicitně deklarované sloupce a pak automaticky vygenerované sloupce.
Poznámka
Automaticky generované sloupce se do Columns kolekce nepřidají.
Vzhled DataGrid ovládacího prvku lze přizpůsobit nastavením vlastností stylu pro různé části ovládacího prvku. V následující tabulce jsou uvedeny různé vlastnosti stylu.
Styl – vlastnost | Description |
---|---|
AlternatingItemStyle | Určuje styl střídavých položek v ovládacím DataGrid prvku. |
EditItemStyle | Určuje styl položky, která se upravuje v ovládacím DataGrid prvku. |
FooterStyle | Určuje styl pro oddíl zápatí v ovládacím DataGrid prvku. |
HeaderStyle | Určuje styl oddílu záhlaví v ovládacím DataGrid prvku. |
ItemStyle | Určuje styl pro položky v ovládacím DataGrid prvku. |
PagerStyle | Určuje styl pro oddíl DataGrid výběru stránky ovládacího prvku. |
SelectedItemStyle | Určuje styl pro vybranou položku v ovládacím DataGrid prvku. |
Můžete také zobrazit nebo skrýt různé části ovládacího prvku. Následující tabulka uvádí vlastnosti, které určují, které části jsou zobrazeny nebo skryté.
Vlastnost | Popis |
---|---|
ShowFooter | Zobrazí nebo skryje část zápatí DataGrid ovládacího prvku. |
ShowHeader | Zobrazí nebo skryje část DataGrid záhlaví ovládacího prvku. |
Vzhled ovládacího prvku můžete řídit tak, že DataGrid prostřednictvím kódu programu přidáte atributy do <td>
značek a <tr>
vykreslovaných ovládacím prvku v prohlížeči. Atributy lze přidat programově zadáním kódu v obslužné rutině události nebo OnItemCreatedOnItemDataBound události.
Chcete-li přidat atribut do značky <td>
, nejprve získejte TableCell objekt, který představuje buňku v ovládacím DataGrid prvku, do kterého chcete přidat atribut. Kolekci Control.ControlsItem pro vlastnost objektu DataGridItemEventArgs předanou do obslužné rutiny události lze použít k získání požadovaného TableCell objektu. Pak můžete použít metodu AttributeCollection.AddAttributes kolekce pro TableCell objekt k přidání atributů do <td>
značky.
Chcete-li přidat atribut do <tr>
značky, nejprve získejte DataGridItem objekt, který představuje řádek v ovládacím DataGrid prvku, do kterého chcete atribut přidat. Vlastnost Item objektu DataGridItemEventArgs předaná do obslužné rutiny události lze použít k získání požadovaného DataGridItem objektu. Pak můžete použít metodu AttributeCollection.AddAttributes kolekce pro DataGridItem objekt k přidání atributů do <tr>
značky.
Usnadnění
Informace o konfiguraci tohoto ovládacího prvku tak, aby vygeneroval značky, které odpovídají standardům přístupnosti, najdete v tématech Přístupnost v sadě Visual Studio a ASP.NET a ASP.NET Ovládací prvky a přístupnost.
Deklarativní syntaxe
<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>
Konstruktory
DataGrid() |
Inicializuje novou instanci DataGrid třídy . |
Pole
CancelCommandName |
|
DeleteCommandName |
Představuje název příkazu Delete. Toto pole je jen ke čtení. |
EditCommandName |
Představuje název příkazu Upravit. Toto pole je jen ke čtení. |
NextPageCommandArgument |
Představuje argument dalšího příkazu. Toto pole je jen ke čtení. |
PageCommandName |
Představuje název příkazu Page. Toto pole je jen ke čtení. |
PrevPageCommandArgument |
Představuje argument příkazu Prev. Toto pole je jen ke čtení. |
SelectCommandName |
Představuje název příkazu Vybrat. Toto pole je jen ke čtení. |
SortCommandName |
Představuje název příkazu Seřadit. Toto pole je jen ke čtení. |
UpdateCommandName |
Představuje název příkazu Update. Toto pole je jen ke čtení. |
Vlastnosti
AccessKey |
Získá nebo nastaví přístupový klíč, který umožňuje rychle přejít na ovládací prvek webového serveru. (Zděděno od WebControl) |
Adapter |
Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control) |
AllowCustomPaging |
Získá nebo nastaví hodnotu, která označuje, zda je povoleno vlastní stránkování. |
AllowPaging |
Získá nebo nastaví hodnotu, která označuje, zda je stránkování povoleno. |
AllowSorting |
Získá nebo nastaví hodnotu, která označuje, zda je povoleno řazení. |
AlternatingItemStyle |
Získá vlastnosti stylu pro střídavé položky v ovládacím DataGrid prvku. |
AppRelativeTemplateSourceDirectory |
Získá nebo nastaví aplikace relativní virtuální adresář nebo UserControl objektuPage, který obsahuje tento ovládací prvek. (Zděděno od Control) |
Attributes |
Získá kolekci libovolných atributů (pouze pro vykreslování), které neodpovídají vlastnostem ovládacího prvku. (Zděděno od WebControl) |
AutoGenerateColumns |
Získá nebo nastaví hodnotu, která označuje, zda BoundColumn jsou objekty automaticky vytvořeny a zobrazeny v ovládacím DataGrid prvku pro každé pole ve zdroji dat. |
BackColor |
Získá nebo nastaví barvu pozadí ovládacího prvku webového serveru. (Zděděno od WebControl) |
BackImageUrl |
Získá nebo nastaví adresu URL obrázku k zobrazení na pozadí DataGrid ovládacího prvku. |
BindingContainer |
Získá ovládací prvek, který obsahuje datové vazby tohoto ovládacího prvku. (Zděděno od Control) |
BorderColor |
Získá nebo nastaví barvu ohraničení webového ovládacího prvku. (Zděděno od WebControl) |
BorderStyle |
Získá nebo nastaví styl ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl) |
BorderWidth |
Získá nebo nastaví šířku ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl) |
Caption |
Získá nebo nastaví text, který se má vykreslit v elementu titulku HTML v ovládacím prvku. Tato vlastnost slouží k tomu, aby byl ovládací prvek přístupnější uživatelům zařízení s technologiemi pro usnadnění. (Zděděno od BaseDataList) |
CaptionAlign |
Získá nebo nastaví vodorovnou nebo svislou pozici html prvku titulku v ovládacím prvku. Tato vlastnost slouží k tomu, aby byl ovládací prvek přístupnější uživatelům zařízení s technologiemi pro usnadnění. (Zděděno od BaseDataList) |
CellPadding |
Získá nebo nastaví velikost místa mezi obsahem buňky a ohraničením buňky. (Zděděno od BaseDataList) |
CellSpacing |
Získá nebo nastaví velikost prostoru mezi buňkami. (Zděděno od BaseDataList) |
ChildControlsCreated |
Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
ClientID |
Získá ID ovládacího prvku pro kód HTML, který je generován ASP.NET. (Zděděno od Control) |
ClientIDMode |
Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti. (Zděděno od Control) |
ClientIDSeparator |
Získá hodnotu znaku představující znak oddělovače použitý ve ClientID vlastnosti. (Zděděno od Control) |
Columns |
Získá kolekci objektů, které představují sloupce DataGrid ovládacího prvku. |
Context |
HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek. (Zděděno od Control) |
Controls |
ControlCollection Získá objekt, který obsahuje kolekci podřízených ovládacích prvků v ovládacím prvku výpisu dat. (Zděděno od BaseDataList) |
ControlStyle |
Získá styl ovládacího prvku webového serveru. Tuto vlastnost používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
ControlStyleCreated |
Získá hodnotu označující, zda Style objekt byl vytvořen pro ControlStyle vlastnost. Tuto vlastnost primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl) |
CssClass |
Získá nebo nastaví css (CSS) třídy vykreslované webový server ovládací prvek v klientovi. (Zděděno od WebControl) |
CurrentPageIndex |
Získá nebo nastaví index aktuálně zobrazené stránky. |
DataItemContainer |
Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataItemContainer. (Zděděno od Control) |
DataKeyField |
Získá nebo nastaví pole klíče ve zdroji dat určeném DataSource vlastností . (Zděděno od BaseDataList) |
DataKeys |
DataKeyCollection Získá objekt, který ukládá hodnoty klíče každého záznamu v ovládacím prvku výpisu dat. (Zděděno od BaseDataList) |
DataKeysArray |
ArrayList Získá objekt, který obsahuje hodnoty klíče každého záznamu v ovládacím prvku výpisu dat. (Zděděno od BaseDataList) |
DataKeysContainer |
Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataKeysControl. (Zděděno od Control) |
DataMember |
Získá nebo nastaví konkrétní datový člen ve vícečlenovém zdroji dat vytvořit vazbu na ovládací prvek výpisu dat. (Zděděno od BaseDataList) |
DataSource |
Získá nebo nastaví zdroj obsahující seznam hodnot sloužící k naplnění položek v rámci ovládacího prvku. (Zděděno od BaseDataList) |
DataSourceID |
Získá nebo nastaví ID vlastnost ovládacího prvku zdroje dat, který by měl ovládací prvek výpisu dat použít k načtení zdroje dat. (Zděděno od BaseDataList) |
DesignMode |
Získá hodnotu označující, zda je ovládací prvek použit na návrhové ploše. (Zděděno od Control) |
EditItemIndex |
Získá nebo nastaví index položky v ovládacím DataGrid prvku upravit. |
EditItemStyle |
Získá vlastnosti stylu položky vybrané pro úpravy v ovládacím prvku DataGrid . |
Enabled |
Získá nebo nastaví hodnotu označující, zda je povolený ovládací prvek webového serveru. (Zděděno od WebControl) |
EnableTheming |
Získá nebo nastaví hodnotu označující, zda motivy použít pro tento ovládací prvek. (Zděděno od WebControl) |
EnableViewState |
Získá nebo nastaví hodnotu určující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, pro žádajícího klienta. (Zděděno od Control) |
Events |
Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení. (Zděděno od Control) |
Font |
Získá vlastnosti písma přidružené k ovládacímu prvku webového serveru. (Zděděno od WebControl) |
FooterStyle |
Získá vlastnosti stylu zápatí oddílu v ovládacím DataGrid prvku. |
ForeColor |
Získá nebo nastaví barvu popředí (obvykle barvu textu) ovládacího prvku webového serveru. (Zděděno od WebControl) |
GridLines |
Získá nebo nastaví hodnotu, která určuje, zda je zobrazena ohraničení mezi buňkami ovládacího prvku výpisu dat. (Zděděno od BaseDataList) |
HasAttributes |
Získá hodnotu označující, zda ovládací prvek má nastaveny atributy. (Zděděno od WebControl) |
HasChildViewState |
Získá hodnotu označující, zda podřízené ovládací prvky aktuálního serveru mají uložené nastavení stavu zobrazení. (Zděděno od Control) |
HeaderStyle |
Získá vlastnosti stylu oddílu nadpisu v ovládacím DataGrid prvku. |
Height |
Získá nebo nastaví výšku ovládacího prvku webového serveru. (Zděděno od WebControl) |
HorizontalAlign |
Získá nebo nastaví vodorovné zarovnání ovládacího prvku výpisu dat v rámci jeho kontejneru. (Zděděno od BaseDataList) |
ID |
Získá nebo nastaví programový identifikátor přiřazený k ovládacímu prvku serveru. (Zděděno od Control) |
IdSeparator |
Získá znak použitý k oddělení identifikátorů ovládacích prvků. (Zděděno od Control) |
Initialized |
Získá hodnotu označující, zda byl ovládací prvek inicializován. (Zděděno od BaseDataList) |
IsBoundUsingDataSourceID |
Získá hodnotu označující, zda DataSourceID je vlastnost nastavena. (Zděděno od BaseDataList) |
IsChildControlStateCleared |
Získá hodnotu označující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav řízení. (Zděděno od Control) |
IsEnabled |
Získá hodnotu označující, zda je ovládací prvek povolen. (Zděděno od WebControl) |
IsTrackingViewState |
Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do stavu zobrazení. (Zděděno od Control) |
IsViewStateEnabled |
Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control) |
Items |
Získá kolekci DataGridItem objektů, které představují jednotlivé položky v ovládacím DataGrid prvku. |
ItemStyle |
Získá vlastnosti stylu položek v ovládacím DataGrid prvku. |
LoadViewStateByID |
Získá hodnotu označující, zda se ovládací prvek účastní načítání stavu ID zobrazení místo indexu. (Zděděno od Control) |
NamingContainer |
Získá odkaz na názvový kontejner ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro rozdíl mezi serverovými ovládacími prvky se stejnou ID hodnotou vlastnosti. (Zděděno od Control) |
Page |
Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control) |
PageCount |
Získá celkový počet stránek potřebných k zobrazení položek v ovládacím DataGrid prvku. |
PagerStyle |
Získá vlastnosti stylu stránkování oddílu DataGrid ovládacího prvku. |
PageSize |
Získá nebo nastaví počet položek, které se mají zobrazit na jedné stránce DataGrid ovládacího prvku. |
Parent |
Získá odkaz na serverový ovládací prvek nadřazený ovládací prvek v hierarchii ovládacích prvků stránky. (Zděděno od Control) |
RenderingCompatibility |
Získá hodnotu, která určuje ASP.NET verze, která vykreslí HTML bude kompatibilní s. (Zděděno od Control) |
RequiresDataBinding |
Získá nebo nastaví hodnotu označující, zda ovládací prvek výpisu dat je třeba vytvořit vazbu na zadaný zdroj dat. (Zděděno od BaseDataList) |
SelectArguments |
DataSourceSelectArguments Získá objekt, který ovládací prvek vázané na data používá při načítání dat z ovládacího prvku zdroje dat. (Zděděno od BaseDataList) |
SelectedIndex |
Získá nebo nastaví index vybrané položky v ovládacím DataGrid prvku. |
SelectedItem |
DataGridItem Získá objekt, který představuje vybranou položku v ovládacím DataGrid prvku. |
SelectedItemStyle |
Získá vlastnosti stylu aktuálně vybrané položky v ovládacím DataGrid prvku. |
ShowFooter |
Získá nebo nastaví hodnotu, která označuje, zda je zápatí zobrazena v ovládacím DataGrid prvku. |
ShowHeader |
Získá nebo nastaví hodnotu, která označuje, zda je záhlaví zobrazena v ovládacím DataGrid prvku. |
Site |
Získá informace o kontejneru, který hostuje aktuální ovládací prvek při vykreslení na návrhové ploše. (Zděděno od Control) |
SkinID |
Získá nebo nastaví kůži na ovládací prvek. (Zděděno od WebControl) |
Style |
Získá kolekci text atributů, které budou vykresleny jako atribut stylu na vnější značku webového serveru ovládacího prvku. (Zděděno od WebControl) |
SupportsDisabledAttribute |
Získá hodnotu, která označuje, zda má ovládací prvek nastavit |
TabIndex |
Získá nebo nastaví index tabulátoru ovládacího prvku webového serveru. (Zděděno od WebControl) |
TagKey |
HtmlTextWriterTag Získá hodnotu DataGrid ovládacího prvku. |
TagKey |
HtmlTextWriterTag Získá hodnotu, která odpovídá ovládacího prvku webového serveru. Tuto vlastnost používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
TagName |
Získá název značky ovládacího prvku. Tuto vlastnost používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
TemplateControl |
Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek. (Zděděno od Control) |
TemplateSourceDirectory |
Získá virtuální adresář Page nebo UserControl , který obsahuje aktuální serverový ovládací prvek. (Zděděno od Control) |
ToolTip |
Získá nebo nastaví text zobrazený, když ukazatel myši najede na ovládací prvek webového serveru. (Zděděno od WebControl) |
UniqueID |
Získá jedinečný hierarchicky kvalifikovaný identifikátor serverového ovládacího prvku. (Zděděno od Control) |
UseAccessibleHeader |
Získá nebo nastaví hodnotu označující, zda ovládací prvek výpisu dat vykresluje záhlaví v přístupném formátu. Tato vlastnost slouží k tomu, aby byl ovládací prvek přístupnější uživatelům zařízení s technologiemi pro usnadnění. (Zděděno od BaseDataList) |
ValidateRequestMode |
Získá nebo nastaví hodnotu, která označuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty. (Zděděno od Control) |
ViewState |
Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení serverového ovládacího prvku napříč více požadavky na stejnou stránku. (Zděděno od Control) |
ViewStateIgnoresCase |
Získá hodnotu, která označuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control) |
ViewStateMode |
Získá nebo nastaví režim zobrazení stavu tohoto ovládacího prvku. (Zděděno od Control) |
VirtualItemCount |
Získá nebo nastaví virtuální počet položek v ovládacím DataGrid prvku při použití vlastního stránkování. |
Visible |
Získá nebo nastaví hodnotu, která označuje, zda je serverový ovládací prvek vykreslen jako uživatelské rozhraní na stránce. (Zděděno od Control) |
Width |
Získá nebo nastaví šířku ovládacího prvku webového serveru. (Zděděno od WebControl) |
Metody
AddAttributesToRender(HtmlTextWriter) |
Přidá atributy a styly HTML, které je potřeba vykreslit na zadaný HtmlTextWriterTag. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
AddedControl(Control, Int32) |
Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control . (Zděděno od Control) |
AddParsedSubObject(Object) |
Upozorní ovládací prvek serveru, že byl analyzován element, xml nebo HTML, a přidá element do kolekce serverového ControlCollection ovládacího prvku. (Zděděno od BaseDataList) |
ApplyStyle(Style) |
Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku a přepíše všechny existující prvky stylu ovládacího prvku. Tuto metodu primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl) |
ApplyStyleSheetSkin(Page) |
Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od Control) |
BeginRenderTracing(TextWriter, Object) |
Zahájí trasování vykreslování dat v době návrhu. (Zděděno od Control) |
BuildProfileTree(String, Boolean) |
Shromáždí informace o ovládacím prvku serveru a doručí je do Trace vlastnosti, která se má zobrazit, když je pro stránku povolené trasování. (Zděděno od Control) |
ClearCachedClientID() |
Nastaví hodnotu v ClientID mezipaměti na |
ClearChildControlState() |
Odstraní informace o stavu řízení pro podřízené ovládací prvky serveru. (Zděděno od Control) |
ClearChildState() |
Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky serveru. (Zděděno od Control) |
ClearChildViewState() |
Odstraní informace o stavu zobrazení všech podřízených ovládacích prvků serveru. (Zděděno od Control) |
ClearEffectiveClientIDMode() |
ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control) |
CopyBaseAttributes(WebControl) |
Zkopíruje vlastnosti, které nejsou zapouzdřeny objektem Style ze zadaného ovládacího prvku webového serveru do ovládacího prvku webového serveru, ze kterého je volána tato metoda. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
CreateChildControls() |
Vytvoří podřízený ovládací prvek pomocí stavu zobrazení. (Zděděno od BaseDataList) |
CreateColumnSet(PagedDataSource, Boolean) |
Vytvoří sadu sloupců, které se mají použít k sestavení řídicí hierarchie. Pokud AutoGenerateColumns je hodnota true, vytvoří se sloupce tak, aby odpovídaly zdroji dat, a připojí se k sadě sloupců definovaných v kolekci Columns . |
CreateControlCollection() |
Vytvoří nový ControlCollection objekt, který bude obsahovat podřízené ovládací prvky (literál i server) serverového ovládacího prvku. (Zděděno od Control) |
CreateControlHierarchy(Boolean) |
Vytvoří hierarchii ovládacích prvků, která se použije k vykreslení .DataGrid |
CreateControlStyle() |
Vytvoří nový styl ovládacího prvku. |
CreateDataSourceSelectArguments() |
Vytvoří výchozí DataSourceSelectArguments objekt používaný ovládacím prvek vázaným na data, pokud nejsou zadány žádné argumenty. (Zděděno od BaseDataList) |
CreateItem(Int32, Int32, ListItemType) |
Vytvoří DataGridItem objekt. |
DataBind() |
Vytvoří vazbu ovládacího prvku a všech jeho podřízených ovládacích prvků na zadaný zdroj dat. (Zděděno od BaseDataList) |
DataBind(Boolean) |
Vytvoří vazbu zdroje dat na vyvoláný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control) |
DataBindChildren() |
Sváže zdroj dat s podřízenými ovládacími prvky serverového ovládacího prvku. (Zděděno od Control) |
Dispose() |
Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control) |
EndRenderTracing(TextWriter, Object) |
Ukončí trasování vykreslovaných dat v době návrhu. (Zděděno od Control) |
EnsureChildControls() |
Určuje, zda serverový ovládací prvek obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control) |
EnsureDataBound() |
Před voláním DataBind() metody ověří, že ovládací prvek výpisu dat vyžaduje datovou vazbu a zda je zadán platný ovládací prvek zdroje dat. (Zděděno od BaseDataList) |
EnsureID() |
Vytvoří identifikátor ovládacích prvků, které nemají přiřazený identifikátor. (Zděděno od Control) |
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
FindControl(String) |
Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek pomocí zadaného |
FindControl(String, Int32) |
Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek se zadaným |
Focus() |
Nastaví fokus vstupu na ovládací prvek. (Zděděno od Control) |
GetData() |
IEnumerableVrátí -implementovaný objekt, který představuje zdroj dat. (Zděděno od BaseDataList) |
GetDesignModeState() |
Získá data v době návrhu pro ovládací prvek. (Zděděno od Control) |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetRouteUrl(Object) |
Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control) |
GetRouteUrl(RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control) |
GetRouteUrl(String, Object) |
Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy. (Zděděno od Control) |
GetRouteUrl(String, RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy. (Zděděno od Control) |
GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
GetUniqueIDRelativeTo(Control) |
Vrátí předponu vlastnosti UniqueID zadaného ovládacího prvku. (Zděděno od Control) |
HasControls() |
Určuje, jestli serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky. (Zděděno od Control) |
HasEvents() |
Vrátí hodnotu označující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control) |
InitializeItem(DataGridItem, DataGridColumn[]) |
Inicializuje zadaný DataGridItem objekt. |
InitializePager(DataGridItem, Int32, PagedDataSource) |
Vytvoří DataGridItem objekt, který obsahuje uživatelské rozhraní stránkování. |
IsLiteralContent() |
Určuje, jestli serverový ovládací prvek obsahuje pouze obsah literálu. (Zděděno od Control) |
LoadControlState(Object) |
Obnoví informace o stavu řízení z předchozího požadavku stránky, který byl uložen metodou SaveControlState() . (Zděděno od Control) |
LoadViewState(Object) |
Načte uložený stav DataGrid. |
MapPathSecure(String) |
Načte fyzickou cestu, na kterou se mapuje virtuální cesta, absolutní nebo relativní. (Zděděno od Control) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
MergeStyle(Style) |
Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku, ale nepřepíše žádné existující prvky stylu ovládacího prvku. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
OnBubbleEvent(Object, EventArgs) |
Událost vyvolanou ovládacím prvek v kontejneru předá hierarchii ovládacích prvků serveru uživatelského rozhraní stránky. |
OnCancelCommand(DataGridCommandEventArgs) |
CancelCommand Vyvolá událost. To vám umožní zadat vlastní obslužnou rutinu události. |
OnDataBinding(EventArgs) |
DataBinding Vyvolá událost ovládacího prvkuBaseDataList. (Zděděno od BaseDataList) |
OnDataPropertyChanged() |
Volá se při změně jedné z vlastností identifikace základního zdroje dat, aby se změnila vazba ovládacího prvku vázaného na data k jeho datům. (Zděděno od BaseDataList) |
OnDataSourceViewChanged(Object, EventArgs) |
DataSourceViewChanged Vyvolá událost. (Zděděno od BaseDataList) |
OnDeleteCommand(DataGridCommandEventArgs) |
DeleteCommand Vyvolá událost. To vám umožní zadat vlastní obslužnou rutinu události. |
OnEditCommand(DataGridCommandEventArgs) |
EditCommand Vyvolá událost. To vám umožní zadat vlastní obslužnou rutinu události. |
OnInit(EventArgs) |
Init Vyvolá událost pro ovládací BaseDataList prvek. (Zděděno od BaseDataList) |
OnItemCommand(DataGridCommandEventArgs) |
ItemCommand Vyvolá událost. To vám umožní zadat vlastní obslužnou rutinu události. |
OnItemCreated(DataGridItemEventArgs) |
ItemCreated Vyvolá událost. To vám umožní zadat vlastní obslužnou rutinu události. |
OnItemDataBound(DataGridItemEventArgs) |
ItemDataBound Vyvolá událost. To vám umožní zadat vlastní obslužnou rutinu události. |
OnLoad(EventArgs) |
Load Vyvolá událost. (Zděděno od BaseDataList) |
OnPageIndexChanged(DataGridPageChangedEventArgs) |
PageIndexChanged Vyvolá událost. To vám umožní zadat vlastní obslužnou rutinu události. |
OnPreRender(EventArgs) |
PreRender Vyvolá událost. (Zděděno od BaseDataList) |
OnSelectedIndexChanged(EventArgs) |
SelectedIndexChanged Vyvolá událost ovládacího prvkuBaseDataList. (Zděděno od BaseDataList) |
OnSortCommand(DataGridSortCommandEventArgs) |
SortCommand Vyvolá událost. To vám umožní zadat vlastní obslužnou rutinu události. |
OnUnload(EventArgs) |
Unload Vyvolá událost. (Zděděno od Control) |
OnUpdateCommand(DataGridCommandEventArgs) |
UpdateCommand Vyvolá událost. To vám umožní zadat vlastní obslužnou rutinu události. |
OpenFile(String) |
Stream Získá zvyk ke čtení souboru. (Zděděno od Control) |
PrepareControlHierarchy() |
Nastaví hierarchii ovládacích prvků pro tento DataGrid ovládací prvek. |
RaiseBubbleEvent(Object, EventArgs) |
Přiřadí všechny zdroje události a její informace nadřazené ovládacímu prvku. (Zděděno od Control) |
RemovedControl(Control) |
Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control) |
Render(HtmlTextWriter) |
Vykreslí ovládací prvek určenému zapisovači HTML. (Zděděno od BaseDataList) |
RenderBeginTag(HtmlTextWriter) |
Vykreslí levou značku HTML ovládacího prvku určenému zapisovači. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
RenderChildren(HtmlTextWriter) |
Vypíše obsah podřízených položek serverového ovládacího prvku do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control) |
RenderContents(HtmlTextWriter) |
Vykreslí obsah ovládacího prvku určenému zapisovači. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
RenderControl(HtmlTextWriter) |
Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povolené. (Zděděno od Control) |
RenderControl(HtmlTextWriter, ControlAdapter) |
Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu. (Zděděno od Control) |
RenderEndTag(HtmlTextWriter) |
Vykreslí koncovou značku HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
ResolveAdapter() |
Získá řídicí adaptér zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control) |
ResolveClientUrl(String) |
Získá adresu URL, kterou lze použít v prohlížeči. (Zděděno od Control) |
ResolveUrl(String) |
Převede adresu URL na adresu URL, která je použitelná v žádajícím klientovi. (Zděděno od Control) |
SaveControlState() |
Uloží všechny změny stavu ovládacího prvku serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Control) |
SaveViewState() |
Uloží aktuální stav souboru DataGrid. |
SetDesignModeState(IDictionary) |
Nastaví data v době návrhu ovládacího prvku. (Zděděno od Control) |
SetRenderMethodDelegate(RenderMethod) |
Přiřadí delegáta obslužné rutiny události, který vykresluje serverový ovládací prvek a jeho obsah do nadřazeného ovládacího prvku. (Zděděno od Control) |
SetTraceData(Object, Object) |
Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování. (Zděděno od Control) |
SetTraceData(Object, Object, Object) |
Nastaví trasovací data pro trasování vykreslování dat v době návrhu pomocí trasovaného objektu, klíče dat trasování a hodnoty dat trasování. (Zděděno od Control) |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
TrackViewState() |
Označí počáteční bod pro zahájení sledování a ukládání změn ovládacího prvku jako součást stavu zobrazení ovládacího prvku. |
Událost
CancelCommand |
Vyvolá se při kliknutí na |
DataBinding |
Nastane, když ovládací prvek serveru vytvoří vazbu na zdroj dat. (Zděděno od Control) |
DeleteCommand |
Vyvolá se při kliknutí na tlačítko Odstranit pro položku v ovládacím DataGrid prvku. |
Disposed |
Nastane při uvolnění serverového ovládacího prvku z paměti, což je poslední fáze životního cyklu řízení serveru, když je požadována stránka ASP.NET. (Zděděno od Control) |
EditCommand |
Vyvolá se při kliknutí na tlačítko Upravit pro položku v ovládacím DataGrid prvku. |
Init |
Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control) |
ItemCommand |
Vyvolá se při kliknutí na libovolné tlačítko v ovládacím DataGrid prvku. |
ItemCreated |
Vyvolá se na serveru při vytvoření položky v ovládacím DataGrid prvku. |
ItemDataBound |
Vyvolá se po položce jsou data svázaná s ovládacím DataGrid prvku. |
Load |
Nastane při načtení serverového ovládacího prvku do objektu Page . (Zděděno od Control) |
PageIndexChanged |
Nastane při kliknutí na jeden z prvků výběru stránky. |
PreRender |
Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control) |
SelectedIndexChanged |
Vyvolá se při výběru jiné položky v ovládacím prvku výpisu dat mezi příspěvky na server. (Zděděno od BaseDataList) |
SortCommand |
Nastane při řazení sloupce. |
Unload |
Vyvolá se při uvolnění serverového ovládacího prvku z paměti. (Zděděno od Control) |
UpdateCommand |
Nastane při kliknutí na tlačítko Aktualizovat pro položku v ovládacím DataGrid prvku. |
Explicitní implementace rozhraní
Metody rozšíření
FindDataSourceControl(Control) |
Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek. |
FindFieldTemplate(Control, String) |
Vrátí šablonu pole pro zadaný sloupec v kontejneru názvů zadaného ovládacího prvku. |
FindMetaTable(Control) |
Vrátí objekt metatable pro ovládací prvek obsahující data. |
GetDefaultValues(INamingContainer) |
Získá kolekci výchozích hodnot pro zadaný datový ovládací prvek. |
GetMetaTable(INamingContainer) |
Získá metadata tabulky pro zadaný datový ovládací prvek. |
SetMetaTable(INamingContainer, MetaTable) |
Nastaví metadata tabulky pro zadaný ovládací prvek dat. |
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Nastaví metadata tabulky a mapování výchozích hodnot pro zadaný ovládací prvek dat. |
SetMetaTable(INamingContainer, MetaTable, Object) |
Nastaví metadata tabulky a mapování výchozích hodnot pro zadaný ovládací prvek dat. |
TryGetMetaTable(INamingContainer, MetaTable) |
Určuje, jestli jsou k dispozici metadata tabulky. |
EnableDynamicData(INamingContainer, Type) |
Umožňuje dynamické chování dat pro zadaný datový ovládací prvek. |
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Umožňuje dynamické chování dat pro zadaný datový ovládací prvek. |
EnableDynamicData(INamingContainer, Type, Object) |
Umožňuje dynamické chování dat pro zadaný datový ovládací prvek. |