DataGridColumnCollection 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í.
Kolekce objektů odvozených DataGridColumnsloupců, které představují sloupce v ovládacím DataGrid prvku. Tuto třídu nelze zdědit.
public ref class DataGridColumnCollection sealed : System::Collections::ICollection, System::Web::UI::IStateManager
public sealed class DataGridColumnCollection : System.Collections.ICollection, System.Web.UI.IStateManager
type DataGridColumnCollection = class
interface ICollection
interface IEnumerable
interface IStateManager
Public NotInheritable Class DataGridColumnCollection
Implements ICollection, IStateManager
- Dědičnost
-
DataGridColumnCollection
- Implementuje
Příklady
Následující příklad kódu ukazuje, jak použít DataGridColumnCollection kolekci k dynamickému přidání sloupce do DataGrid ovládacího prvku. Všimněte si, že Columns vlastnost DataGrid ovládacího prvku je instance DataGridColumnCollection třídy.
<%@ 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)
{
// Create a DataGrid control.
DataGrid ItemsGrid = new DataGrid();
// Set the properties of the DataGrid.
ItemsGrid.ID = "ItemsGrid";
ItemsGrid.BorderColor = System.Drawing.Color.Black;
ItemsGrid.CellPadding = 3;
ItemsGrid.AutoGenerateColumns = false;
// Set the styles for the DataGrid.
ItemsGrid.HeaderStyle.BackColor =
System.Drawing.Color.FromArgb(0x0000aaaa);
// Create the columns for the DataGrid control. The DataGrid
// columns are dynamically generated. Therefore, the columns
// must be re-created each time the page is refreshed.
// Create and add the columns to the collection.
ItemsGrid.Columns.Add(CreateBoundColumn("IntegerValue", "Item"));
ItemsGrid.Columns.Add(
CreateBoundColumn("StringValue", "Description"));
ItemsGrid.Columns.Add(
CreateBoundColumn("CurrencyValue", "Price", "{0:c}",
HorizontalAlign.Right));
ItemsGrid.Columns.Add(
CreateLinkColumn("http://www.microsoft.com", "_self",
"Microsoft", "Related link"));
// Specify the data source and bind it to the control.
ItemsGrid.DataSource = CreateDataSource();
ItemsGrid.DataBind();
// Add the DataGrid control to the Controls collection of
// the PlaceHolder control.
Place.Controls.Add(ItemsGrid);
}
BoundColumn CreateBoundColumn(String DataFieldValue,
String HeaderTextValue)
{
// This version of the CreateBoundColumn method sets only the
// DataField and HeaderText properties.
// Create a BoundColumn.
BoundColumn column = new BoundColumn();
// Set the properties of the BoundColumn.
column.DataField = DataFieldValue;
column.HeaderText = HeaderTextValue;
return column;
}
BoundColumn CreateBoundColumn(String DataFieldValue,
String HeaderTextValue, String FormatValue,
HorizontalAlign AlignValue)
{
// This version of CreateBoundColumn method sets the DataField,
// HeaderText, and DataFormatString properties. It also sets the
// HorizontalAlign property of the ItemStyle property of the column.
// Create a BoundColumn using the overloaded CreateBoundColumn method.
BoundColumn column = CreateBoundColumn(DataFieldValue, HeaderTextValue);
// Set the properties of the BoundColumn.
column.DataFormatString = FormatValue;
column.ItemStyle.HorizontalAlign = AlignValue;
return column;
}
HyperLinkColumn CreateLinkColumn(String NavUrlValue,
String TargetValue, String TextValue, String HeaderTextValue)
{
// Create a BoundColumn.
HyperLinkColumn column = new HyperLinkColumn();
// Set the properties of the ButtonColumn.
column.NavigateUrl = NavUrlValue;
column.Target = TargetValue;
column.Text = TextValue;
column.HeaderText = HeaderTextValue;
return column;
}
</script>
<head runat="server">
<title>DataGrid Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataGrid Constructor Example</h3>
<b>Product List</b>
<asp:PlaceHolder id="Place"
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)
' Create a DataGrid control.
Dim ItemsGrid As DataGrid = New DataGrid()
' Set the properties of the DataGrid.
ItemsGrid.ID = "ItemsGrid"
ItemsGrid.BorderColor = System.Drawing.Color.Black
ItemsGrid.CellPadding = 3
ItemsGrid.AutoGenerateColumns = False
' Set the styles for the DataGrid.
ItemsGrid.HeaderStyle.BackColor = System.Drawing.Color.FromArgb(&H0000aaaa)
' Create the columns for the DataGrid control. The DataGrid
' columns are dynamically generated. Therefore, the columns
' must be re-created each time the page is refreshed.
' Create and add the columns to the collection.
ItemsGrid.Columns.Add(CreateBoundColumn("IntegerValue", "Item"))
ItemsGrid.Columns.Add( _
CreateBoundColumn("StringValue", "Description"))
ItemsGrid.Columns.Add( _
CreateBoundColumn("CurrencyValue", "Price", "{0:c}", _
HorizontalAlign.Right))
ItemsGrid.Columns.Add( _
CreateLinkColumn("http:'www.microsoft.com", "_self", _
"Microsoft", "Related link"))
' Specify the data source and bind it to the control.
ItemsGrid.DataSource = CreateDataSource()
ItemsGrid.DataBind()
' Add the DataGrid control to the Controls collection of
' the PlaceHolder control.
Place.Controls.Add(ItemsGrid)
End Sub
Function CreateBoundColumn(DataFieldValue As String, HeaderTextValue As String) As BoundColumn
' This version of CreateBoundColumn method sets only the
' DataField and HeaderText properties.
' Create a BoundColumn.
Dim column As BoundColumn = New BoundColumn()
' Set the properties of the BoundColumn.
column.DataField = DataFieldValue
column.HeaderText = HeaderTextValue
Return column
End Function
Function CreateBoundColumn(DataFieldValue As String, _
HeaderTextValue As String, FormatValue As String, _
AlignValue As HorizontalAlign) As BoundColumn
' This version of CreateBoundColumn method sets the DataField,
' HeaderText, and DataFormatString properties. It also sets the
' HorizontalAlign property of the ItemStyle property of the column.
' Create a BoundColumn using the overloaded CreateBoundColumn method.
Dim column As BoundColumn = CreateBoundColumn(DataFieldValue, HeaderTextValue)
' Set the properties of the BoundColumn.
column.DataFormatString = FormatValue
column.ItemStyle.HorizontalAlign = AlignValue
Return column
End Function
Function CreateLinkColumn(NavUrlValue As String, TargetValue As String, _
TextValue As String, HeaderTextValue As String) As HyperLinkColumn
' Create a BoundColumn.
Dim column As HyperLinkColumn = New HyperLinkColumn()
' Set the properties of the ButtonColumn.
column.NavigateUrl = NavUrlValue
column.Target = TargetValue
column.Text = TextValue
column.HeaderText = HeaderTextValue
Return column
End Function
</script>
<head runat="server">
<title>DataGrid Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataGrid Constructor Example</h3>
<b>Product List</b>
<asp:PlaceHolder id="Place"
runat="server"/>
</form>
</body>
</html>
Poznámky
DataGridColumnCollection Pomocí kolekce můžete programově spravovat kolekci objektů odvozených DataGridColumnsloupců. Tyto objekty představují sloupce v ovládacím DataGrid prvku. Do kolekce můžete přidávat, odebírat nebo vkládat sloupce DataGridColumnCollection .
Poznámka
AutoGenerateColumns Pokud je vlastnost nastavena na true,
sloupce vytvořené ovládacím DataGrid prvku nejsou přidány Columns do kolekce.
Ovládací DataGrid prvek neukládá obsah své Columns kolekce do stavu zobrazení. Pokud chcete sloupec přidat nebo odebrat dynamicky, musíte sloupec přidat nebo odebrat programově při každé aktualizaci stránky. Page_Init
Zadejte funkci, která přidá nebo odebere sloupec před DataGrid opětovným načtením stavu ovládacího prvku a ovládací prvek se znovu sestaví. V opačném případě se změny Columns kolekce při zobrazení neprojeví v ovládacím DataGrid prvku.
Poznámka
I když můžete sloupce do kolekce DataGrid ovládacího prvku přidávat nebo odebírat Columns prostřednictvím kódu programu, je jednodušší vypsat sloupce staticky a pak pomocí Visible vlastnosti zobrazit nebo skrýt jednotlivé sloupce.
Pořadí sloupců v kolekci určuje pořadí zobrazení sloupců v ovládacím DataGrid prvku.
Následující tabulka uvádí různé třídy sloupců, které jsou odvozeny od DataGridColumn třídy.
Column – třída | Description |
---|---|
BoundColumn | Sloupec, který je svázán s polem ve zdroji dat. Zobrazí každou položku v poli jako text. Toto je výchozí typ DataGrid sloupce ovládacího prvku. |
ButtonColumn | Sloupec zobrazující příkazové tlačítko pro každou položku ve sloupci. To vám umožní vytvořit sloupec vlastních ovládacích prvků tlačítek, jako jsou tlačítka Přidat nebo Odebrat. |
EditCommandColumn | Sloupec, který obsahuje příkazy pro úpravy pro každou položku ve sloupci. |
HyperLinkColumn | Sloupec, který zobrazuje každou položku ve sloupci jako hypertextový odkaz. Obsah sloupce může být svázán s polem ve zdroji dat nebo se statickým textem. |
TemplateColumn | Sloupec, který zobrazuje každou položku ve sloupci podle zadané šablony. To vám umožní řídit obsah sloupce, například zobrazit obrázky. |
Poznámka
Třída DataGridColumn je základní třídou pro uvedené třídy sloupců. Nepoužívá se přímo v kolekci DataGridColumnCollection .
Konstruktory
DataGridColumnCollection(DataGrid, ArrayList) |
Inicializuje novou instanci DataGridColumnCollection třídy. |
Vlastnosti
Count |
Získá počet sloupců v kolekci DataGridColumnCollection . |
IsReadOnly |
Získá hodnotu, která označuje, zda sloupce v DataGridColumnCollection kolekci lze upravit. |
IsSynchronized |
Získá hodnotu označující, zda je přístup k DataGridColumnCollection kolekci synchronizován (bezpečné vlákno). |
Item[Int32] |
DataGridColumnZíská -odvozený sloupcový objekt z DataGridColumnCollection kolekce v zadaném indexu. |
SyncRoot |
Získá objekt, který lze použít k synchronizaci přístupu k kolekci DataGridColumnCollection . |
Metody
Add(DataGridColumn) |
Připojí zadaný DataGridColumnobjekt odvozeného sloupce na konec DataGridColumnCollection kolekce. |
AddAt(Int32, DataGridColumn) |
Vloží objekt odvozeného DataGridColumnsloupce do DataGridColumnCollection kolekce v zadaném indexu. |
Clear() |
Odebere všechny DataGridColumnobjekty odvozeného sloupce z DataGridColumnCollection kolekce. |
CopyTo(Array, Int32) |
Zkopíruje položky z DataGridColumnCollection kolekce do zadaného Arrayindexu počínaje zadaným indexem v souboru Array. |
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
GetEnumerator() |
IEnumerator Vrátí rozhraní, které obsahuje všechny objekty odvozeného DataGridColumnsloupce v kolekciDataGridColumnCollection. |
GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
GetType() |
Type Získá aktuální instanci. (Zděděno od Object) |
IndexOf(DataGridColumn) |
Vrátí index zadaného DataGridColumnobjektu odvozeného sloupce z DataGridColumnCollection kolekce. |
MemberwiseClone() |
Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object) |
Remove(DataGridColumn) |
Odebere zadaný DataGridColumnobjekt odvozeného sloupce z DataGridColumnCollection kolekce. |
RemoveAt(Int32) |
Odebere objekt odvozeného DataGridColumnsloupce z kolekce v zadaném DataGridColumnCollection indexu. |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
Explicitní implementace rozhraní
IStateManager.IsTrackingViewState |
Získá hodnotu označující, jestli kolekce sleduje změny stavu zobrazení. |
IStateManager.LoadViewState(Object) |
Načte dříve uložený stav. |
IStateManager.SaveViewState() |
Vrátí objekt obsahující změny stavu. |
IStateManager.TrackViewState() |
Spustí sledování změn stavu. |
Metody rozšíření
Cast<TResult>(IEnumerable) |
Přetypuje prvky zadaného IEnumerable typu. |
OfType<TResult>(IEnumerable) |
Filtruje prvky IEnumerable založené na zadaném typu. |
AsParallel(IEnumerable) |
Umožňuje paralelizaci dotazu. |
AsQueryable(IEnumerable) |
Převede na IEnumerable IQueryable. |