DataColumn Třída

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

Zdroj:

DataColumn.cs

Představuje schéma sloupce v objektu DataTable.

public ref class DataColumn : System::ComponentModel::MarshalByValueComponent

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataColumn : System.ComponentModel.MarshalByValueComponent

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataColumn = class
    inherit MarshalByValueComponent

Public Class DataColumn
Inherits MarshalByValueComponent

Dědičnost

Object

MarshalByValueComponent

DataColumn

Atributy

DynamicallyAccessedMembersAttribute

Příklady

Následující příklad vytvoří s DataTable několika DataColumn objekty.

private void MakeTable()
{
    // Create a DataTable.
    DataTable table = new DataTable("Product");

    // Create a DataColumn and set various properties.
    DataColumn column = new DataColumn();
    column.DataType = System.Type.GetType("System.Decimal");
    column.AllowDBNull = false;
    column.Caption = "Price";
    column.ColumnName = "Price";
    column.DefaultValue = 25;

    // Add the column to the table.
    table.Columns.Add(column);

    // Add 10 rows and set values.
    DataRow row;
    for(int i = 0; i < 10; i++)
    {
        row = table.NewRow();
        row["Price"] = i + 1;

        // Be sure to add the new row to the
        // DataRowCollection.
        table.Rows.Add(row);
    }
}

Private Sub MakeTable()
    ' Create a DataTable. 
    Dim table As New DataTable("Product")

    ' Create a DataColumn and set various properties. 
    Dim column As New DataColumn()
    column.DataType = System.Type.GetType("System.Decimal") 
    column.AllowDBNull = False 
    column.Caption = "Price"  
    column.ColumnName = "Price" 
    column.DefaultValue = 25 

    ' Add the column to the table. 
    table.Columns.Add(column) 

    ' Add 10 rows and set values. 
    Dim row As DataRow 
    Dim i As Integer  
    For i = 0 to 9 
        row = table.NewRow() 
        row("Price") = i + 1 

        ' Be sure to add the new row to 
        ' the DataRowCollection. 
        table.Rows.Add(row) 
    Next i 
End Sub

Poznámky

Jedná se DataColumn o základní stavební blok pro vytvoření schématu DataTable. Schéma vytvoříte přidáním jednoho nebo více DataColumn objektů do objektu DataColumnCollection. Další informace naleznete v tématu Přidání sloupců do tabulky DataTable.

Každá DataColumn má DataType vlastnost, která určuje druh dat, která DataColumn obsahuje. Můžete například omezit datový typ na celá čísla nebo řetězce nebo desetinná místa. Vzhledem k tomu, že data obsažená v objektu DataTable jsou obvykle sloučena zpět do původního zdroje dat, musíte se shodovat s datovými typy s daty ve zdroji dat. Další informace naleznete v tématu Mapování datových typů v ADO.NET.

Vlastnosti, jako AllowDBNullje , Uniquea ReadOnly umisťovat omezení pro zadávání a aktualizaci dat, což pomáhá zaručit integritu dat. K řízení automatického generování dat můžete také použít AutoIncrement, AutoIncrementSeeda AutoIncrementStep vlastnosti. Další informace o sloupcích najdete v AutoIncrement tématu Vytváření sloupců automatického zvýšení. Další informace naleznete v tématu Definování primárních klíčů.

Můžete také zajistit, aby hodnoty v objektu DataColumn byly jedinečné tak, že vytvoříte UniqueConstraint a přidáte je do ConstraintCollectionDataTable objektu, do kterého DataColumn patří. Další informace naleznete v tématu Omezení tabulky DataTable.

Chcete-li vytvořit vztah mezi DataColumn objekty, vytvořte DataRelation objekt a přidejte ho do DataRelationCollection objektu DataSet.

Vlastnost objektu DataColumn můžete použít Expression k výpočtu hodnot ve sloupci nebo k vytvoření agregovaného sloupce. Další informace naleznete v tématu Vytváření sloupců výrazů.

Konstruktory

Name	Description
DataColumn()	Inicializuje novou instanci DataColumn třídy jako typ řetězec.
DataColumn(String, Type, String, MappingType)	Inicializuje novou instanci třídy pomocí zadaného názvu, datového DataColumn typu, výrazu a hodnoty, která určuje, zda sloupec je atribut.
DataColumn(String, Type, String)	Inicializuje novou instanci třídy pomocí zadaného názvu, datového DataColumn typu a výrazu.
DataColumn(String, Type)	Inicializuje novou instanci třídy pomocí zadaného DataColumn názvu sloupce a datového typu.
DataColumn(String)	Inicializuje novou instanci DataColumn třídy jako řetězec typu pomocí zadaného názvu sloupce.

Vlastnosti

Name	Description
AllowDBNull	Získá nebo nastaví hodnotu, která určuje, zda jsou hodnoty null povoleny v tomto sloupci pro řádky, které patří do tabulky.
AutoIncrement	Získá nebo nastaví hodnotu, která určuje, zda sloupec automaticky zvýší hodnotu sloupce pro nové řádky přidané do tabulky.
AutoIncrementSeed	Získá nebo nastaví počáteční hodnotu pro sloupec, který má jeho AutoIncrement vlastnost nastavena na true. Výchozí hodnota je 0.
AutoIncrementStep	Získá nebo nastaví přírůstek používaný sloupcem s jeho AutoIncrement vlastností nastavena na true.
Caption	Získá nebo nastaví titulek sloupce.
ColumnMapping	Získá nebo nastaví MappingType sloupec.
ColumnName	Získá nebo nastaví název sloupce v sadě DataColumnCollection.
Container	Získá kontejner pro komponentu. (Zděděno od MarshalByValueComponent)
DataType	Získá nebo nastaví typ dat uložených ve sloupci.
DateTimeMode	Získá nebo nastaví DateTimeMode sloupec.
DefaultValue	Získá nebo nastaví výchozí hodnotu sloupce při vytváření nových řádků.
DesignMode	Získá hodnotu určující, zda komponenta je aktuálně v režimu návrhu. (Zděděno od MarshalByValueComponent)
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k této komponentě. (Zděděno od MarshalByValueComponent)
Expression	Získá nebo nastaví výraz použitý k filtrování řádků, výpočet hodnot ve sloupci nebo vytvoření agregačního sloupce.
ExtendedProperties	Získá kolekci vlastních informací o uživateli přidružených k objektu DataColumn.
MaxLength	Získá nebo nastaví maximální délku textového sloupce.
Namespace	Získá nebo nastaví obor názvů DataColumn.
Ordinal	Získá pozici sloupce v kolekci DataColumnCollection (založený na nule).
Prefix	Získá nebo nastaví předponu XML, která aliasy oboru názvů DataTable.
ReadOnly	Získá nebo nastaví hodnotu, která určuje, zda sloupec umožňuje změny hned po přidání řádku do tabulky.
Site	Získá nebo nastaví lokalitu komponenty. (Zděděno od MarshalByValueComponent)
Table	DataTable Získá, ke kterému sloupec patří.
Unique	Získá nebo nastaví hodnotu, která určuje, zda hodnoty v každém řádku sloupce musí být jedinečné.

Metody

Name	Description
CheckNotAllowNull()	Tento člen podporuje infrastrukturu .NET a není určen k použití přímo z vašeho kódu.
CheckUnique()	Tento člen podporuje infrastrukturu .NET a není určen k použití přímo z vašeho kódu.
Dispose()	Uvolní všechny prostředky používané nástrojem MarshalByValueComponent. (Zděděno od MarshalByValueComponent)
Dispose(Boolean)	Uvolní nespravované prostředky používané MarshalByValueComponent a volitelně uvolní spravované prostředky. (Zděděno od MarshalByValueComponent)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetService(Type)	Získá implementátor .IServiceProvider (Zděděno od MarshalByValueComponent)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnPropertyChanging(PropertyChangedEventArgs)	Tento člen podporuje infrastrukturu .NET a není určen k použití přímo z vašeho kódu.
RaisePropertyChanging(String)	Tento člen podporuje infrastrukturu .NET a není určen k použití přímo z vašeho kódu.
SetOrdinal(Int32)	Změní pořadové číslo nebo pozici DataColumn na zadanou pořadovou nebo pozici.
ToString()	Expression Získá sloupec, pokud existuje.

Událost

Name	Description
Disposed	Přidá obslužnou rutinu Disposed události pro naslouchání události v komponentě. (Zděděno od MarshalByValueComponent)

Bezpečný přístup z více vláken

Tento typ je bezpečný pro operace čtení s více vlákny. Je nutné synchronizovat všechny operace zápisu.

Viz také

• Add(DataColumn)
• DataColumnCollection
• Constraints
• ConstraintCollection
• DataGrid
• DataRow
• DataTable
• DataSet
• NewRow()
• DataRowCollection
• UniqueConstraint
• Použití datových sad v ADO.NET