DataGrid Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Um controlo de lista limitada a dados que apresenta os itens da fonte de dados numa tabela. O DataGrid controlo permite-lhe selecionar, ordenar e editar estes itens.
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- Herança
- Implementações
Exemplos
O exemplo de código seguinte demonstra como usar o DataGrid controlo para mostrar os itens na fonte de dados.
<%@ 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>
O exemplo de código seguinte demonstra como usar o DataGrid controlo para um carrinho de compras simples.
<%@ 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>
O exemplo de código seguinte demonstra como adicionar dinamicamente atributos às <td> etiquetas and <tr> geradas pelo DataGrid controlo.
<%@ 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>
Observações
Neste tópico:
Introduction
Use o DataGrid controlo para mostrar os campos de uma fonte de dados como colunas numa tabela. Cada linha no DataGrid controlo representa um registo na fonte de dados. O DataGrid controlo suporta seleção, edição, eliminação, paginação e ordenação.
Caution
Este controlo pode ser usado para mostrar a entrada do utilizador, que pode incluir scripts de cliente maliciosos. Verifique qualquer informação enviada por um cliente para scripts executáveis, instruções SQL ou outro código antes de a exibir na sua aplicação. ASP.NET fornece uma funcionalidade de validação de pedidos de entrada para bloquear scripts e HTML na entrada do utilizador. São também fornecidos controlos de servidor de validação para avaliar a entrada do utilizador. Para mais informações, consulte Sintaxe de Controlo do Servidor de Validação.
Diferentes tipos de colunas determinam o comportamento das colunas no controlo. A tabela seguinte lista os diferentes tipos de colunas que podem ser utilizados.
| Tipo de Coluna | Description |
|---|---|
| BoundColumn | Mostra uma coluna atribuída a um campo numa fonte de dados. Mostra cada item no campo como texto. Este é o tipo de coluna padrão do DataGrid controlo. |
| ButtonColumn | Mostra um botão de comando para cada item na coluna. Isto permite-lhe criar uma coluna de controlos personalizados de botões, como Add botões ou.Remove |
| EditCommandColumn | Apresenta uma coluna que contém comandos de edição para cada item da coluna. |
| HyperLinkColumn | Exibe o conteúdo de cada item na coluna como um hiperlink. O conteúdo da coluna pode ser associado a um campo numa fonte de dados ou num texto estático. |
| TemplateColumn | Exibe cada item na coluna após um modelo especificado. Isto permite-lhe fornecer controlos personalizados na coluna. |
Por defeito, a AutoGenerateColumns propriedade está definida como true, o que cria um BoundColumn objeto para cada campo na fonte de dados. Cada campo é então renderizado como uma coluna no DataGrid controlo, pela ordem em que cada campo aparece na fonte de dados.
Também pode controlar manualmente quais as colunas que aparecem no DataGrid controlo, definindo a AutoGenerateColumns propriedade para false e depois listando as colunas que quer incluir entre as etiquetas de abertura e fecho <Columns> . As colunas especificadas são adicionadas à Columns coleção pela ordem indicada. Isto permite-te controlar programaticamente as colunas no DataGrid controlo.
Note
A ordem em que as colunas são apresentadas no DataGrid controlo é controlada pela ordem em que as colunas aparecem na Columns coleção. Embora possas alterar programaticamente a ordem das colunas manipulando a Columns coleção, é mais fácil listar as colunas na ordem de exibição desejada.
Colunas explicitamente declaradas podem ser exibidas em conjunto com colunas geradas automaticamente. Ao usar ambos, as colunas explicitamente declaradas serão renderizadas primeiro, seguidas pelas colunas geradas automaticamente.
Note
Colunas geradas automaticamente não são adicionadas à Columns coleção.
A aparência do DataGrid controlo pode ser personalizada definindo as propriedades de estilo para as diferentes partes do comando. A tabela seguinte lista as diferentes propriedades de estilo.
| Propriedade Style | Description |
|---|---|
| AlternatingItemStyle | Especifica o estilo para alternar itens no DataGrid controlo. |
| EditItemStyle | Especifica o estilo do item a ser editado no DataGrid controlo. |
| FooterStyle | Especifica o estilo da secção do rodapé no DataGrid controlo. |
| HeaderStyle | Especifica o estilo da secção do cabeçalho no DataGrid controlo. |
| ItemStyle | Especifica o estilo dos itens no DataGrid controlo. |
| PagerStyle | Especifica o estilo para a secção de seleção de páginas do DataGrid controlo. |
| SelectedItemStyle | Especifica o estilo do item selecionado no DataGrid controlo. |
Também podes mostrar ou esconder diferentes partes do controlo. A tabela seguinte lista as propriedades que controlam quais partes são mostradas ou ocultas.
| Property | Description |
|---|---|
| ShowFooter | Mostra ou esconde a secção do rodapé do DataGrid comando. |
| ShowHeader | Mostra ou esconde a secção do cabeçalho do DataGrid controlo. |
Pode controlar a aparência do DataGrid controlo adicionando programaticamente atributos às <td> etiquetas and <tr> renderizadas pelo controlo no navegador. Os atributos podem ser adicionados programaticamente fornecendo código no handler de eventos para o OnItemCreated evento ou.OnItemDataBound
Para adicionar um atributo à <td> etiqueta, primeiro obtenha o TableCell objeto que representa a célula no DataGrid controlo ao qual quer adicionar o atributo. A Control.Controls coleção da Item propriedade do DataGridItemEventArgs objeto passada no gestor de eventos pode ser usada para obter o objeto desejado TableCell . Pode então usar o AttributeCollection.Add método da Attributes coleção para o TableCell objeto adicionar atributos à <td> etiqueta.
Para adicionar um atributo à <tr> etiqueta, primeiro obtenha o DataGridItem objeto que representa a linha no DataGrid controlo ao qual quer adicionar o atributo. A Item propriedade do DataGridItemEventArgs objeto passado para o gestor de eventos pode ser usada para obter o objeto desejado DataGridItem . Pode então usar o AttributeCollection.Add método da Attributes coleção para o DataGridItem objeto adicionar atributos à <tr> etiqueta.
Accessibility
Para informações sobre como configurar este controlo de modo a gerar marcação que cumpra os padrões de acessibilidade, consulte Acessibilidade em Visual Studio e ASP.NET e ASP.NET Controlos e Acessibilidade.
Sintaxe declarativa
<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>
Construtores
| Name | Description |
|---|---|
| DataGrid() |
Inicializa uma nova instância da DataGrid classe. |
Campos
| Name | Description |
|---|---|
| CancelCommandName |
Representa o nome do |
| DeleteCommandName |
Representa o nome do comando Eliminar. Este campo é só de leitura. |
| EditCommandName |
Representa o nome do comando Editar. Este campo é só de leitura. |
| NextPageCommandArgument |
Representa o argumento do comando Seguinte. Este campo é só de leitura. |
| PageCommandName |
Representa o nome do comando Página. Este campo é só de leitura. |
| PrevPageCommandArgument |
Representa o argumento do comando Prev. Este campo é só de leitura. |
| SelectCommandName |
Representa o nome do comando Select. Este campo é só de leitura. |
| SortCommandName |
Representa o nome do comando Ordenar. Este campo é só de leitura. |
| UpdateCommandName |
Representa o nome do comando Update. Este campo é só de leitura. |
Propriedades
| Name | Description |
|---|---|
| AccessKey |
Obtém ou define a chave de acesso que permite navegar rapidamente até ao controlo do servidor Web. (Herdado de WebControl) |
| Adapter |
Recebe o adaptador específico do navegador para o controlo. (Herdado de Control) |
| AllowCustomPaging |
Recebe ou define um valor que indica se a paginação personalizada está ativada. |
| AllowPaging |
Recebe ou define um valor que indica se a paginação está ativada. |
| AllowSorting |
Recebe ou define um valor que indica se a ordenação está ativada. |
| AlternatingItemStyle |
Obtém as propriedades de estilo para alternar itens no DataGrid controlo. |
| AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo. (Herdado de Control) |
| Attributes |
Obtém a coleção de atributos arbitrários (apenas para renderização) que não correspondem a propriedades no controlo. (Herdado de WebControl) |
| AutoGenerateColumns |
Recebe ou define um valor que indica se BoundColumn os objetos são automaticamente criados e exibidos no DataGrid controlo de cada campo da fonte de dados. |
| BackColor |
Obtém ou define a cor de fundo do controlo do servidor Web. (Herdado de WebControl) |
| BackImageUrl |
Obtém ou define a URL de uma imagem para ser exibida no fundo do DataGrid controlo. |
| BindingContainer |
Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control) |
| BorderColor |
Obtém ou define a cor da borda do controlo Web. (Herdado de WebControl) |
| BorderStyle |
Obtém ou define o estilo de borda do controlo do servidor Web. (Herdado de WebControl) |
| BorderWidth |
Obtém ou define a largura da fronteira do controlo do servidor Web. (Herdado de WebControl) |
| Caption |
Obtém ou define o texto para renderizar num elemento de legenda HTML no controlo. Esta propriedade é disponibilizada para tornar o controlo mais acessível aos utilizadores de dispositivos de tecnologia assistiva. (Herdado de BaseDataList) |
| CaptionAlign |
Obtém ou define a posição horizontal ou vertical do elemento da legenda HTML num controlo. Esta propriedade é disponibilizada para tornar o controlo mais acessível aos utilizadores de dispositivos de tecnologia assistiva. (Herdado de BaseDataList) |
| CellPadding |
Obtém ou define a quantidade de espaço entre o conteúdo de uma célula e a borda da célula. (Herdado de BaseDataList) |
| CellSpacing |
Obtém ou define a quantidade de espaço entre as células. (Herdado de BaseDataList) |
| ChildControlsCreated |
Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados. (Herdado de Control) |
| ClientID |
Obtém o ID de controlo para a marcação HTML gerada pelo ASP.NET. (Herdado de Control) |
| ClientIDMode |
Obtém ou define o algoritmo que é usado para gerar o valor da ClientID propriedade. (Herdado de Control) |
| ClientIDSeparator |
Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade. (Herdado de Control) |
| Columns |
Obtém uma coleção de objetos que representam as colunas do DataGrid controlo. |
| Context |
Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual. (Herdado de Control) |
| Controls |
Obtém um ControlCollection objeto que contém uma coleção de controlos filhos num controlo de listagem de dados. (Herdado de BaseDataList) |
| ControlStyle |
Recebe o estilo do controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl) |
| ControlStyleCreated |
Recebe um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl) |
| CssClass |
Obtém ou define a classe Cascading Style Sheet (CSS) renderizada pelo controlo do servidor Web no cliente. (Herdado de WebControl) |
| CurrentPageIndex |
Obtém ou define o índice da página atualmente apresentada. |
| DataItemContainer |
Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer. (Herdado de Control) |
| DataKeyField |
Obtém ou define o campo-chave na fonte de dados especificada pela DataSource propriedade. (Herdado de BaseDataList) |
| DataKeys |
Obtém um DataKeyCollection objeto que armazena os valores-chave de cada registo num controlo de listagem de dados. (Herdado de BaseDataList) |
| DataKeysArray |
Obtém um ArrayList objeto que contém os valores-chave de cada registo num controlo de listagem de dados. (Herdado de BaseDataList) |
| DataKeysContainer |
Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl. (Herdado de Control) |
| DataMember |
Obtém ou define o elemento de dados específico numa fonte de dados multimembro para se ligar a um controlo de listagem de dados. (Herdado de BaseDataList) |
| DataSource |
Obtém ou define a fonte contendo uma lista de valores usados para preencher os itens dentro do controlo. (Herdado de BaseDataList) |
| DataSourceID |
Obtém ou define a ID propriedade do controlo de fonte de dados que o controlo de listagem de dados deve usar para recuperar a sua fonte de dados. (Herdado de BaseDataList) |
| DesignMode |
Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control) |
| EditItemIndex |
Obtém ou define o índice de um item no DataGrid controlo para editar. |
| EditItemStyle |
Obtém as propriedades de estilo do item selecionadas para edição no DataGrid controlo. |
| Enabled |
Recebe ou define um valor que indica se o controlo do servidor Web está ativado. (Herdado de WebControl) |
| EnableTheming |
Recebe ou define um valor que indica se os temas se aplicam a este controlo. (Herdado de WebControl) |
| EnableViewState |
Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante. (Herdado de Control) |
| Events |
Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control) |
| Font |
Obtém as propriedades da fonte associadas ao controlo do servidor Web. (Herdado de WebControl) |
| FooterStyle |
Obtém as propriedades de estilo da secção do rodapé no DataGrid controlo. |
| ForeColor |
Obtém ou define a cor do primeiro plano (tipicamente a cor do texto) do controlo do servidor Web. (Herdado de WebControl) |
| GridLines |
Recebe ou define um valor que especifica se a fronteira entre as células de um controlo de listagem de dados é apresentada. (Herdado de BaseDataList) |
| HasAttributes |
Recebe um valor que indica se o controlo tem atributos definidos. (Herdado de WebControl) |
| HasChildViewState |
Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada. (Herdado de Control) |
| HeaderStyle |
Obtém as propriedades de estilo da secção de cabeçalho no DataGrid controlo. |
| Height |
Obtém ou define a altura do controlo do servidor Web. (Herdado de WebControl) |
| HorizontalAlign |
Obtém ou define o alinhamento horizontal de um controlo de listagem de dados dentro do seu contentor. (Herdado de BaseDataList) |
| ID |
Obtém ou define o identificador programático atribuído ao controlo do servidor. (Herdado de Control) |
| IdSeparator |
Faz com que o carácter seja usado para separar identificadores de controlo. (Herdado de Control) |
| Initialized |
Recebe um valor que indica se o controlo foi inicializado. (Herdado de BaseDataList) |
| IsBoundUsingDataSourceID |
Recebe um valor que indica se a DataSourceID propriedade está definida. (Herdado de BaseDataList) |
| IsChildControlStateCleared |
Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control) |
| IsEnabled |
Recebe um valor que indica se o controlo está ativado. (Herdado de WebControl) |
| IsTrackingViewState |
Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização. (Herdado de Control) |
| IsViewStateEnabled |
Recebe um valor que indica se o estado de visualização está ativado para este controlo. (Herdado de Control) |
| Items |
Obtém uma coleção de DataGridItem objetos que representam os itens individuais no DataGrid controlo. |
| ItemStyle |
Obtém as propriedades de estilo dos itens no DataGrid controlo. |
| LoadViewStateByID |
Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index. (Herdado de Control) |
| NamingContainer |
Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade. (Herdado de Control) |
| Page |
Obtém uma referência à Page instância que contém o controlo do servidor. (Herdado de Control) |
| PageCount |
Obtém o número total de páginas necessárias para mostrar os itens no DataGrid controlo. |
| PagerStyle |
Obtém as propriedades de estilo da secção de paginação do DataGrid controlo. |
| PageSize |
Obtém ou define o número de itens a mostrar numa única página do DataGrid controlo. |
| Parent |
Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página. (Herdado de Control) |
| RenderingCompatibility |
Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
| RequiresDataBinding |
Recebe ou define um valor que indica se o controlo da listagem de dados precisa de se ligar à sua fonte de dados especificada. (Herdado de BaseDataList) |
| SelectArguments |
Obtém um DataSourceSelectArguments objeto que o controlo data-bound usa ao recuperar dados de um controlo de fonte de dados. (Herdado de BaseDataList) |
| SelectedIndex |
Obtém ou define o índice do item selecionado no DataGrid controlo. |
| SelectedItem |
Obtém um DataGridItem objeto que representa o item selecionado no DataGrid controlo. |
| SelectedItemStyle |
Obtém as propriedades de estilo do item atualmente selecionado no DataGrid controlo. |
| ShowFooter |
Obtém ou define um valor que indica se o rodapé é exibido no DataGrid controlo. |
| ShowHeader |
Recebe ou define um valor que indica se o cabeçalho é exibido no DataGrid controlo. |
| Site |
Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design. (Herdado de Control) |
| SkinID |
Obtém ou fixa a pele para aplicar no controlo. (Herdado de WebControl) |
| Style |
Recebe uma coleção de atributos de texto que serão renderizados como um atributo de estilo na etiqueta externa do controlo do servidor Web. (Herdado de WebControl) |
| SupportsDisabledAttribute |
Obtém um valor que indica se o controlo deve definir o |
| TabIndex |
Obtém ou define o índice de tabulação do controlo do servidor Web. (Herdado de WebControl) |
| TagKey |
Obtém o HtmlTextWriterTag valor do DataGrid controlo. |
| TagKey |
Obtém o HtmlTextWriterTag valor correspondente a este controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl) |
| TagName |
Recebe o nome da etiqueta de controlo. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl) |
| TemplateControl |
Recebe ou define uma referência ao template que contém esse controlo. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor. (Herdado de Control) |
| ToolTip |
Obtém ou define o texto exibido quando o ponteiro do rato paira sobre o controlo do servidor Web. (Herdado de WebControl) |
| UniqueID |
Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control) |
| UseAccessibleHeader |
Recebe ou define um valor que indica se o controlo da listagem de dados renderiza o seu cabeçalho num formato acessível. Esta propriedade é disponibilizada para tornar o controlo mais acessível aos utilizadores de dispositivos de tecnologia assistiva. (Herdado de BaseDataList) |
| ValidateRequestMode |
Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control) |
| ViewState |
Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página. (Herdado de Control) |
| ViewStateIgnoresCase |
Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas. (Herdado de Control) |
| ViewStateMode |
Obtém ou define o modo view-state deste controlo. (Herdado de Control) |
| VirtualItemCount |
Obtém ou define o número virtual de itens no DataGrid controlo quando é usada paginação personalizada. |
| Visible |
Recebe ou define um valor que indica se um controlo de servidor é renderizado como UI na página. (Herdado de Control) |
| Width |
Obtém ou define a largura do controlo do servidor Web. (Herdado de WebControl) |
Métodos
| Name | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Adiciona atributos e estilos HTML que precisam de ser renderizados para o especificado HtmlTextWriterTag. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| AddedControl(Control, Int32) |
Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control) |
| AddParsedSubObject(Object) |
Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento à coleção do ControlCollection controlo do servidor. (Herdado de BaseDataList) |
| ApplyStyle(Style) |
Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, sobrescrevendo quaisquer elementos de estilo existentes do controlo. Este método é usado principalmente por desenvolvedores de controlo. (Herdado de WebControl) |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo. (Herdado de Control) |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreio em tempo de design dos dados de renderização. (Herdado de Control) |
| BuildProfileTree(String, Boolean) |
Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página. (Herdado de Control) |
| ClearCachedClientID() |
Define o valor em ClientID cache para |
| ClearChildControlState() |
Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor. (Herdado de Control) |
| ClearChildState() |
Apaga a informação de view-state e control-state de todos os controlos filhos do servidor. (Herdado de Control) |
| ClearChildViewState() |
Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit. (Herdado de Control) |
| CopyBaseAttributes(WebControl) |
Copia as propriedades não encapsuladas pelo Style objeto do controlo do servidor Web especificado para o controlo do servidor Web de onde este método é chamado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| CreateChildControls() |
Cria um controlo filho usando o estado de visualização. (Herdado de BaseDataList) |
| CreateColumnSet(PagedDataSource, Boolean) |
Cria o conjunto de colunas a ser usado para construir a hierarquia de controlo. Quando AutoGenerateColumns é verdadeiro, as colunas são criadas para corresponder à fonte de dados e são anexadas ao conjunto de colunas definido na Columns coleção. |
| CreateControlCollection() |
Cria um novo ControlCollection objeto para armazenar os controlos filhos (tanto literais como de servidor) do controlo do servidor. (Herdado de Control) |
| CreateControlHierarchy(Boolean) |
Cria a hierarquia de controlo que é usada para renderizar o DataGrid. |
| CreateControlStyle() |
Cria um novo estilo de controlo. |
| CreateDataSourceSelectArguments() |
Cria um objeto padrão DataSourceSelectArguments usado pelo controlo data-bound se não forem especificados argumentos. (Herdado de BaseDataList) |
| CreateItem(Int32, Int32, ListItemType) |
Cria um objeto DataGridItem. |
| DataBind() |
Vincula o controlo e todos os seus controlos filhos à fonte de dados especificada. (Herdado de BaseDataList) |
| DataBind(Boolean) |
Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento. (Herdado de Control) |
| DataBindChildren() |
Vincula uma fonte de dados aos controlos filhos do controlo do servidor. (Herdado de Control) |
| Dispose() |
Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Termina o rastreio de tempo de design dos dados de renderização. (Herdado de Control) |
| EnsureChildControls() |
Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos. (Herdado de Control) |
| EnsureDataBound() |
Verifica que o controlo de listagem de dados requer ligação de dados e que um controlo de fonte válido é especificado antes de chamar o DataBind() método. (Herdado de BaseDataList) |
| EnsureID() |
Cria um identificador para controlos que não têm um identificador atribuído. (Herdado de Control) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FindControl(String, Int32) |
Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado |
| FindControl(String) |
Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado |
| Focus() |
Define o foco de entrada num controlo. (Herdado de Control) |
| GetData() |
Devolve um IEnumerableobjeto -implementado que representa a fonte de dados. (Herdado de BaseDataList) |
| GetDesignModeState() |
Obtém dados de tempo de projeto para um controlo. (Herdado de Control) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetRouteUrl(Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(String, Object) |
Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUniqueIDRelativeTo(Control) |
Devolve a parte prefixada da UniqueID propriedade do controlo especificado. (Herdado de Control) |
| HasControls() |
Determina se o controlo do servidor contém algum controlo filho. (Herdado de Control) |
| HasEvents() |
Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos. (Herdado de Control) |
| InitializeItem(DataGridItem, DataGridColumn[]) |
Inicializa o objeto especificado DataGridItem . |
| InitializePager(DataGridItem, Int32, PagedDataSource) |
Cria um DataGridItem objeto que contém a interface de paginação. |
| IsLiteralContent() |
Determina se o controlo do servidor contém apenas conteúdo literal. (Herdado de Control) |
| LoadControlState(Object) |
Restaura a informação do estado de controlo a partir de um pedido de página anterior que foi guardado pelo SaveControlState() método. (Herdado de Control) |
| LoadViewState(Object) |
Carrega um estado guardado do DataGrid. |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia. (Herdado de Control) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MergeStyle(Style) |
Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, mas não sobrescreve quaisquer elementos de estilo existentes do controlo. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Transmite o evento gerado por um controlo dentro do contentor pela hierarquia de controlo do servidor UI da página. |
| OnCancelCommand(DataGridCommandEventArgs) |
Eleva o CancelCommand evento. Isto permite-lhe fornecer um handler personalizado para o evento. |
| OnDataBinding(EventArgs) |
Aumenta o DataBinding evento de um BaseDataList controlo. (Herdado de BaseDataList) |
| OnDataPropertyChanged() |
Chamada quando uma das propriedades base de identificação da fonte de dados é alterada, para reatribuir o controlo data-bound aos seus dados. (Herdado de BaseDataList) |
| OnDataSourceViewChanged(Object, EventArgs) |
Eleva o DataSourceViewChanged evento. (Herdado de BaseDataList) |
| OnDeleteCommand(DataGridCommandEventArgs) |
Eleva o DeleteCommand evento. Isto permite-lhe fornecer um handler personalizado para o evento. |
| OnEditCommand(DataGridCommandEventArgs) |
Eleva o EditCommand evento. Isto permite-lhe fornecer um handler personalizado para o evento. |
| OnInit(EventArgs) |
Aumenta o Init evento para o BaseDataList controlo. (Herdado de BaseDataList) |
| OnItemCommand(DataGridCommandEventArgs) |
Eleva o ItemCommand evento. Isto permite-lhe fornecer um handler personalizado para o evento. |
| OnItemCreated(DataGridItemEventArgs) |
Eleva o ItemCreated evento. Isto permite-lhe fornecer um handler personalizado para o evento. |
| OnItemDataBound(DataGridItemEventArgs) |
Eleva o ItemDataBound evento. Isto permite-lhe fornecer um handler personalizado para o evento. |
| OnLoad(EventArgs) |
Eleva o Load evento. (Herdado de BaseDataList) |
| OnPageIndexChanged(DataGridPageChangedEventArgs) |
Eleva o PageIndexChanged evento. Isto permite-lhe fornecer um handler personalizado para o evento. |
| OnPreRender(EventArgs) |
Eleva o PreRender evento. (Herdado de BaseDataList) |
| OnSelectedIndexChanged(EventArgs) |
Aumenta o SelectedIndexChanged evento de um BaseDataList controlo. (Herdado de BaseDataList) |
| OnSortCommand(DataGridSortCommandEventArgs) |
Eleva o SortCommand evento. Isto permite-lhe fornecer um handler personalizado para o evento. |
| OnUnload(EventArgs) |
Eleva o Unload evento. (Herdado de Control) |
| OnUpdateCommand(DataGridCommandEventArgs) |
Eleva o UpdateCommand evento. Isto permite-lhe fornecer um handler personalizado para o evento. |
| OpenFile(String) |
Recebe um Stream usado para ler um ficheiro. (Herdado de Control) |
| PrepareControlHierarchy() |
Estabelece a hierarquia de controlo para este DataGrid controlo. |
| RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes do evento e da sua informação ao pai do controlo. (Herdado de Control) |
| RemovedControl(Control) |
Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control) |
| Render(HtmlTextWriter) |
Renderiza o controlo para o escritor HTML especificado. (Herdado de BaseDataList) |
| RenderBeginTag(HtmlTextWriter) |
Renderiza a etiqueta de abertura HTML do controlo ao escritor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| RenderChildren(HtmlTextWriter) |
Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderContents(HtmlTextWriter) |
Apresenta o conteúdo do controlo ao autor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control) |
| RenderControl(HtmlTextWriter) |
Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado. (Herdado de Control) |
| RenderEndTag(HtmlTextWriter) |
Renderiza a etiqueta HTML de fecho do controlo no escritor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| ResolveAdapter() |
Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado. (Herdado de Control) |
| ResolveClientUrl(String) |
Recebe um URL que pode ser usado pelo navegador. (Herdado de Control) |
| ResolveUrl(String) |
Converte uma URL numa que seja utilizável no cliente solicitante. (Herdado de Control) |
| SaveControlState() |
Guarda quaisquer alterações no estado de controlo do servidor que tenham ocorrido desde que a página foi publicada de volta no servidor. (Herdado de Control) |
| SaveViewState() |
Guarda o estado atual do DataGrid. |
| SetDesignModeState(IDictionary) |
Define dados em tempo de projeto para um controlo. (Herdado de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai. (Herdado de Control) |
| SetTraceData(Object, Object, Object) |
Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço. (Herdado de Control) |
| SetTraceData(Object, Object) |
Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço. (Herdado de Control) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| TrackViewState() |
Marca o ponto de partida para começar a acompanhar e guardar alterações ao controlo como parte do estado da vista de controlo. |
evento
| Name | Description |
|---|---|
| CancelCommand |
Ocorre quando o |
| DataBinding |
Ocorre quando o controlo do servidor se liga a uma fonte de dados. (Herdado de Control) |
| DeleteCommand |
Ocorre quando o botão Delete é clicado para um item no DataGrid controlo. |
| Disposed |
Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
| EditCommand |
Acontece quando o botão Editar é clicado para um item no DataGrid controlo. |
| Init |
Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida. (Herdado de Control) |
| ItemCommand |
Ocorre quando qualquer botão é pressionado no DataGrid controlo. |
| ItemCreated |
Ocorre no servidor quando um item no DataGrid controlo é criado. |
| ItemDataBound |
Ocorre depois de um item estar ligado a dados ao DataGrid controlo. |
| Load |
Ocorre quando o controlo do servidor é carregado no Page objeto. (Herdado de Control) |
| PageIndexChanged |
Ocorre quando um dos elementos de seleção de página é clicado. |
| PreRender |
Ocorre depois do carregamento do Control objeto, mas antes da renderização. (Herdado de Control) |
| SelectedIndexChanged |
Ocorre quando um item diferente é selecionado num controlo de listagem de dados entre publicações no servidor. (Herdado de BaseDataList) |
| SortCommand |
Ocorre quando uma coluna é ordenada. |
| Unload |
Ocorre quando o controlo do servidor é descarregado da memória. (Herdado de Control) |
| UpdateCommand |
Ocorre quando o botão Atualizar é clicado para um item no DataGrid controlo. |
Implementações de Interface Explícita
Métodos da Extensão
| Name | Description |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado. |
| EnableDynamicData(INamingContainer, Type, Object) |
Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado. |
| EnableDynamicData(INamingContainer, Type) |
Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado. |
| FindDataSourceControl(Control) |
Devolve a fonte de dados associada ao controlo de dados para o controlo especificado. |
| FindFieldTemplate(Control, String) |
Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado. |
| FindMetaTable(Control) |
Devolve o objeto metatable para o controlo de dados que contém. |
| GetDefaultValues(INamingContainer) |
Obtém a recolha dos valores padrão para o controlo de dados especificado. |
| GetMetaTable(INamingContainer) |
Obtém os metadados da tabela para o controlo de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable) |
Define os metadados da tabela para o controlo de dados especificado. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Determina se os metadados da tabela estão disponíveis. |