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 svázán s polem 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 zobrazíte 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.
Note
Tento typ sloupce je výchozím nastavením DataGrid ovládacího prvku.
Chcete-li řídit vzhled tohoto sloupce, použijte vlastnosti DataGrid stylu ovládacího prvku.
Caution
Text není kódován 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, aby se snížila ohrožení zabezpečení.
Konstruktory
| Name | Description |
|---|---|
| BoundColumn() |
Inicializuje novou instanci BoundColumn třídy. |
Pole
| Name | Description |
|---|---|
| thisExpr |
Představuje řetězec "!". Toto pole je určeno pouze ke čtení. |
Vlastnosti
| Name | Description |
|---|---|
| DataField |
Získá nebo nastaví název pole ze zdroje dat pro vazbu na BoundColumn. |
| DataFormatString |
Získá nebo nastaví řetězec, který určuje formát zobrazení pro položky ve sloupci. |
| DesignMode |
Získá hodnotu, která označuje, zda je sloupec 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 zápatí oddílu 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 záhlaví oddílu 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, který je sloupec členem. (Zděděno od DataGridColumn) |
| ReadOnly |
Získá nebo nastaví hodnotu, která určuje, zda lze položky v BoundColumn upravit. |
| SortExpression |
Získá nebo nastaví název pole nebo výraz předat metodě OnSortCommand(DataGridSortCommandEventArgs) 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 uložit jeho vlastnosti. (Zděděno od DataGridColumn) |
| Visible |
Získá nebo nastaví hodnotu, která určuje, zda je sloupec viditelný v ovládacím DataGrid prvku. (Zděděno od DataGridColumn) |
Metody
| Name | Description |
|---|---|
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| FormatDataValue(Object) |
Převede zadanou hodnotu do formátu určeného DataFormatString vlastností. |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| Initialize() |
BoundColumn Obnoví počáteční stav. |
| InitializeCell(TableCell, Int32, ListItemType) |
Obnoví zadanou buňku v počátečním BoundColumn stavu. |
| LoadViewState(Object) |
Načte stav objektu DataGridColumn . (Zděděno od DataGridColumn) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního 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í v ovládacím 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í
| Name | Description |
|---|---|
| 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) |