DataGridColumnCollection Třída

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

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: Object
DataGridColumnCollection

Implementuje: ICollection IEnumerable IStateManager

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.

Platí pro

Sdílet prostřednictvím

DataGridColumnCollection Třída

Definice

Příklady

Poznámky

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Metody rozšíření

Platí pro

Viz také

Další materiály