BoundColumn 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í.
Typ sloupce pro DataGrid ovládací prvek, který je vázán na pole ve zdroji dat.
public ref class BoundColumn : System::Web::UI::WebControls::DataGridColumn
public class BoundColumn : System.Web.UI.WebControls.DataGridColumn
type BoundColumn = class
inherit DataGridColumn
Public Class BoundColumn
Inherits DataGridColumn
- Dědičnost
Příklady
Následující příklad ukazuje, jak použít BoundColumn typ sloupce v ovládacím DataGrid prvku k zobrazení polí 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>BoundColumn Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>BoundColumn 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
HeaderText="Number"
DataField="IntegerValue">
</asp:BoundColumn>
<asp:BoundColumn
HeaderText="Description"
DataField="StringValue">
</asp:BoundColumn>
<asp:BoundColumn
HeaderText="Price"
DataField="CurrencyValue"
DataFormatString="{0:c}">
</asp:BoundColumn>
</Columns>
</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>BoundColumn Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>BoundColumn 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
HeaderText="Number"
DataField="IntegerValue">
</asp:BoundColumn>
<asp:BoundColumn
HeaderText="Description"
DataField="StringValue">
</asp:BoundColumn>
<asp:BoundColumn
HeaderText="Price"
DataField="CurrencyValue"
DataFormatString="{0:c}">
</asp:BoundColumn>
</Columns>
</asp:DataGrid>
</form>
</body>
</html>
Poznámky
BoundColumn Pomocí typu sloupce v ovládacím DataGrid prvku zobrazte obsah pole ve zdroji dat. Hodnoty jsou uvedeny v jednom sloupci. Pole je propojené se BoundColumnzdrojem dat, takže všechny aktualizace ve zdroji dat se projeví v odpovídajících buňkách DataGrid ovládacího prvku.
Poznámka
Tento typ sloupce je výchozím DataGrid nastavením ovládacího prvku.
Chcete-li řídit vzhled tohoto sloupce, použijte vlastnosti DataGrid stylu ovládacího prvku.
Upozornění
Text není kódován kódem HTML před zobrazením v souboru BoundColumn. To umožňuje vložit skript do značek HTML do textu. Pokud hodnoty pro tento sloupec pocházejí ze vstupu uživatele, nezapomeňte ověřit hodnoty, které snižují ohrožení zabezpečení.
Konstruktory
BoundColumn() |
Inicializuje novou instanci BoundColumn třídy. |
Pole
thisExpr |
Představuje řetězec "!". Toto pole je jen ke čtení. |
Vlastnosti
DataField |
Získá nebo nastaví název pole ze zdroje dat pro vazbu k sadě BoundColumn. |
DataFormatString |
Získá nebo nastaví řetězec, který určuje formát zobrazení položek ve sloupci. |
DesignMode |
Získá hodnotu, která označuje, zda sloupec je v režimu návrhu. (Zděděno od DataGridColumn) |
FooterStyle |
Získá vlastnosti stylu pro oddíl zápatí sloupce. (Zděděno od DataGridColumn) |
FooterText |
Získá nebo nastaví text zobrazený v oddílu zápatí sloupce. (Zděděno od DataGridColumn) |
HeaderImageUrl |
Získá nebo nastaví umístění obrázku, který se zobrazí v oddílu záhlaví sloupce. (Zděděno od DataGridColumn) |
HeaderStyle |
Získá vlastnosti stylu pro oddíl záhlaví sloupce. (Zděděno od DataGridColumn) |
HeaderText |
Získá nebo nastaví text zobrazený v oddílu záhlaví sloupce. (Zděděno od DataGridColumn) |
IsTrackingViewState |
Získá hodnotu, která určuje, zda DataGridColumn je objekt označen k uložení jeho stavu. (Zděděno od DataGridColumn) |
ItemStyle |
Získá vlastnosti stylu pro buňky položky ve sloupci. (Zděděno od DataGridColumn) |
Owner |
DataGrid Získá ovládací prvek, ze kterého je sloupec členem. (Zděděno od DataGridColumn) |
ReadOnly |
Získá nebo nastaví hodnotu, která označuje, zda položky v souboru BoundColumn lze upravit. |
SortExpression |
Získá nebo nastaví název pole nebo výrazu pro předání OnSortCommand(DataGridSortCommandEventArgs) metodě při výběru sloupce pro řazení. (Zděděno od DataGridColumn) |
ViewState |
StateBag Získá objekt, který umožňuje sloupec odvozený z DataGridColumn třídy ukládat jeho vlastnosti. (Zděděno od DataGridColumn) |
Visible |
Získá nebo nastaví hodnotu, která označuje, jestli je sloupec viditelný v ovládacím DataGrid prvku. (Zděděno od DataGridColumn) |
Metody
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
FormatDataValue(Object) |
Převede zadanou hodnotu do formátu označeného DataFormatString vlastností. |
GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
GetType() |
Type Získá aktuální instanci. (Zděděno od Object) |
Initialize() |
BoundColumn Obnoví počáteční stav. |
InitializeCell(TableCell, Int32, ListItemType) |
Obnoví zadanou buňku BoundColumn v počátečním stavu. |
LoadViewState(Object) |
Načte stav objektu DataGridColumn . (Zděděno od DataGridColumn) |
MemberwiseClone() |
Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object) |
OnColumnChanged() |
Volá metodu OnColumnsChanged() . (Zděděno od DataGridColumn) |
SaveViewState() |
Uloží aktuální stav objektu DataGridColumn . (Zděděno od DataGridColumn) |
ToString() |
Vrátí řetězcovou reprezentaci sloupce. (Zděděno od DataGridColumn) |
TrackViewState() |
Způsobí sledování změn stavu zobrazení ovládacího prvku serveru, aby je bylo možné uložit do objektu StateBag ovládacího prvku serveru. (Zděděno od DataGridColumn) |
Explicitní implementace rozhraní
IStateManager.IsTrackingViewState |
Získá hodnotu, která označuje, zda sloupec sleduje změny stavu zobrazení. (Zděděno od DataGridColumn) |
IStateManager.LoadViewState(Object) |
Načte dříve uložený stav. (Zděděno od DataGridColumn) |
IStateManager.SaveViewState() |
Vrátí objekt obsahující změny stavu. (Zděděno od DataGridColumn) |
IStateManager.TrackViewState() |
Spustí sledování změn stavu. (Zděděno od DataGridColumn) |