Sdílet prostřednictvím


DataColumn Třída

Definice

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

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 DataColumnDataType 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 DataRelationCollectionDataSet.

Vlastnost objektu ExpressionDataColumn 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.

Viz také