DataColumn Třída

Reference

Definice

Obor názvů:: System.Data

Sestavení:: System.Data.Common.dll

Sestavení:: System.Data.dll

Sestavení:: netstandard.dll

Zdroj:: DataColumn.cs

Zdroj:: DataColumn.cs

Zdroj:: DataColumn.cs

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í.

Představuje schéma sloupce v objektu DataTable.

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

public class DataColumn : System.ComponentModel.MarshalByValueComponent

type DataColumn = class
    inherit MarshalByValueComponent

Public Class DataColumn
Inherits MarshalByValueComponent

Dědičnost: Object

MarshalByValueComponent
DataColumn

Příklady

Následující příklad vytvoří objekt DataTable s 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

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

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

Vlastnosti, jako AllowDBNulljsou , Uniquea ReadOnly omezují zadávání a aktualizaci dat, a pomáhají tak zajistit integritu dat. K řízení automatického AutoIncrementgenerování dat můžete použít také vlastnosti , AutoIncrementSeeda AutoIncrementStep . Další informace o AutoIncrement sloupcích najdete v tématu Vytváření sloupců s automatickými přírůstky. Další informace najdete v tématu Definování primárních klíčů.

Můžete také zajistit jedinečnost hodnot v souboru DataColumn tak, že vytvoříte UniqueConstraint a přidáte ho k ConstraintCollection hodnotě DataTable , do které DataColumn patří. Další informace najdete v tématu Omezení tabulky DataTable.

Pokud chcete vytvořit relaci mezi DataColumn objekty, vytvořte DataRelation objekt a přidejte ho do objektu DataRelationCollection DataSet.

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

Konstruktory

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

Vlastnosti

AllowDBNull	Získá nebo nastaví hodnotu, která označuje, zda jsou hodnoty null povoleny v tomto sloupci pro řádky, které patří do tabulky.
AutoIncrement	Získá nebo nastaví hodnotu, která označ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á vlastnost AutoIncrement nastavenou na `true`. Výchozí hodnota je 0.
AutoIncrementStep	Získá nebo nastaví přírůstek používaný sloupcem s jeho AutoIncrement vlastností nastavenou na `true`.
Caption	Získá nebo nastaví popis pro sloupec.
ColumnMapping	Získá nebo nastaví MappingType sloupec .
ColumnName	Získá nebo nastaví název sloupce v objektu 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` pro sloupec .
DefaultValue	Získá nebo nastaví výchozí hodnotu sloupce při vytváření nových řádků.
DesignMode	Získá hodnotu označující, zda je komponenta 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čtu hodnot ve sloupci nebo vytvoření agregačního sloupce.
ExtendedProperties	Získá kolekci vlastních informací o uživateli přidružené k DataColumn.
MaxLength	Získá nebo nastaví maximální délku textového sloupce.
Namespace	Získá nebo nastaví obor názvů objektu DataColumn.
Ordinal	Získá (od nuly) pozice sloupce v kolekci DataColumnCollection .
Prefix	Získá nebo nastaví předponu XML, která aliasuje obor názvů DataTable.
ReadOnly	Získá nebo nastaví hodnotu, která označuje, zda sloupec umožňuje změny, jakmile byl řádek přidán do tabulky.
Site	Získá nebo nastaví lokalitu komponenty. (Zděděno od MarshalByValueComponent)
Table	Získá, DataTable do kterého sloupec patří.
Unique	Získá nebo nastaví hodnotu, která označuje, zda hodnoty v každém řádku sloupce musí být jedinečné.

Metody

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é nástrojem MarshalByValueComponent a volitelně uvolní spravované prostředky. (Zděděno od MarshalByValueComponent)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetService(Type)	Získá implementátor objektu IServiceProvider. (Zděděno od MarshalByValueComponent)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (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 řadovou nebo pozici.
ToString()	Získá ze Expression sloupce, pokud existuje.

Událost

Disposed

Přidá obslužnou rutinu události pro naslouchání Disposed události komponenty.

(Zděděno od MarshalByValueComponent)

Metody rozšíření

GetKeyedService<T>(IServiceProvider, Object)	Získá službu typu `T` z .IServiceProvider
GetKeyedServices(IServiceProvider, Type, Object)	Získá výčet služeb typu `serviceType` z IServiceProvider.
GetKeyedServices<T>(IServiceProvider, Object)	Získá výčet služeb typu `T` z IServiceProvider.
GetRequiredKeyedService(IServiceProvider, Type, Object)	Získá službu typu `serviceType` z .IServiceProvider
GetRequiredKeyedService<T>(IServiceProvider, Object)	Získá službu typu `T` z .IServiceProvider
CreateAsyncScope(IServiceProvider)	Vytvoří nový AsyncServiceScope , který lze použít k vyřešení služeb s vymezeným oborem.
CreateScope(IServiceProvider)	Vytvoří nový IServiceScope , který lze použít k vyřešení služeb s vymezeným oborem.
GetRequiredService(IServiceProvider, Type)	Získejte službu typu `serviceType` z .IServiceProvider
GetRequiredService<T>(IServiceProvider)	Získejte službu typu `T` z .IServiceProvider
GetService<T>(IServiceProvider)	Získejte službu typu `T` z .IServiceProvider
GetServices(IServiceProvider, Type)	Získejte výčet služeb typu `serviceType` z .IServiceProvider
GetServices<T>(IServiceProvider)	Získejte výčet služeb typu `T` z .IServiceProvider
GetFakeLogCollector(IServiceProvider)	Získá objekt, který shromažďuje záznamy protokolu odeslané do falešné protokolovací nástroje.
GetFakeRedactionCollector(IServiceProvider)	Získá falešné redactor kolektor instance z kontejneru injektáž závislostí.

Platí pro

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

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