DataColumn.DataType Vlastnost

Reference

Definice

Obor názvů:: System.Data

Sestavení:: System.Data.Common.dll

Sestavení:: System.Data.dll

Sestavení:: netstandard.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í.

Získá nebo nastaví typ dat uložených ve sloupci.

public:
 property Type ^ DataType { Type ^ get(); void set(Type ^ value); };

[System.ComponentModel.TypeConverter(typeof(System.Data.ColumnTypeConverter))]
public Type DataType { get; set; }

public Type DataType { get; set; }

[System.ComponentModel.TypeConverter(typeof(System.Data.ColumnTypeConverter))]
[System.Data.DataSysDescription("DataColumnDataTypeDescr")]
public Type DataType { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Data.ColumnTypeConverter))>]
member this.DataType : Type with get, set

member this.DataType : Type with get, set

[<System.ComponentModel.TypeConverter(typeof(System.Data.ColumnTypeConverter))>]
[<System.Data.DataSysDescription("DataColumnDataTypeDescr")>]
member this.DataType : Type with get, set

Public Property DataType As Type

Hodnota vlastnosti

Type

Objekt Type , který představuje datový typ sloupce.

Atributy: TypeConverterAttribute DataSysDescriptionAttribute

Výjimky

ArgumentException

Sloupec už obsahuje uložená data.

Příklady

Následující příklad přidá do tabulky sloupce několika datových typů DataTablea pak přidá jeden řádek do tabulky.

public DataTable MakeDataTable(){

    DataTable myTable;
    DataRow myNewRow;
    // Create a new DataTable.
    myTable = new DataTable("My Table");

    // Create DataColumn objects of data types.
    DataColumn colString = new DataColumn("StringCol");
    colString.DataType = System.Type.GetType("System.String");
    myTable.Columns.Add(colString);

    DataColumn colInt32 = new DataColumn("Int32Col");
    colInt32.DataType = System.Type.GetType("System.Int32");
    myTable.Columns.Add(colInt32);

    DataColumn colBoolean = new DataColumn("BooleanCol");
    colBoolean.DataType = System.Type.GetType("System.Boolean");
    myTable.Columns.Add(colBoolean);

    DataColumn colTimeSpan = new DataColumn("TimeSpanCol");
    colTimeSpan.DataType = System.Type.GetType("System.TimeSpan");
    myTable.Columns.Add(colTimeSpan);

    DataColumn colDateTime = new DataColumn("DateTimeCol");
    colDateTime.DataType = System.Type.GetType("System.DateTime");
    myTable.Columns.Add(colDateTime);

    DataColumn colDecimal = new DataColumn("DecimalCol");
    colDecimal.DataType = System.Type.GetType("System.Decimal");
    myTable.Columns.Add(colDecimal);

    DataColumn colByteArray = new DataColumn("ByteArrayCol");
    colByteArray.DataType = System.Type.GetType("System.Byte[]");
    myTable.Columns.Add(colByteArray);

    // Populate one row with values.
    myNewRow = myTable.NewRow();

    myNewRow["StringCol"] = "Item Name";
    myNewRow["Int32Col"] = 2147483647;
    myNewRow["BooleanCol"] = true;
    myNewRow["TimeSpanCol"] = new TimeSpan(10,22,10,15,100);
    myNewRow["DateTimeCol"] = System.DateTime.Today;
    myNewRow["DecimalCol"] = 64.0021;
    myNewRow["ByteArrayCol"] = new Byte[] { 1, 5, 120 };
    myTable.Rows.Add(myNewRow);
    return myTable;
 }

Public Function MakeDataTable() As DataTable
    
    Dim myTable As DataTable 
    Dim myNewRow As DataRow 
    ' Create a new DataTable.
    myTable = New DataTable("My Table")
 
    ' Create DataColumn objects of data types.
    Dim colString As New DataColumn("StringCol")
    colString.DataType = System.Type.GetType("System.String")
    myTable.Columns.Add(colString) 
 
    Dim colInt32 As New DataColumn("Int32Col")
    colInt32.DataType = System.Type.GetType("System.Int32")
    myTable.Columns.Add(colInt32)
 
    Dim colBoolean As New DataColumn("BooleanCol")
    colBoolean.DataType = System.Type.GetType("System.Boolean")
    myTable.Columns.Add(colBoolean)
 
    Dim colTimeSpan As New DataColumn("TimeSpanCol")
    colTimeSpan.DataType = System.Type.GetType("System.TimeSpan")
    myTable.Columns.Add(colTimeSpan)
 
    Dim colDateTime As New DataColumn("DateTimeCol")
    colDateTime.DataType = System.Type.GetType("System.DateTime")
    myTable.Columns.Add(colDateTime)
 
    Dim colDecimal As New DataColumn("DecimalCol")
    colDecimal.DataType = System.Type.GetType("System.Decimal")
    myTable.Columns.Add(colDecimal)
 
    ' Populate one row with values.
    myNewRow = myTable.NewRow()
 
    myNewRow("StringCol") = "Item Name"
    myNewRow("Int32Col") = 2147483647
    myNewRow("BooleanCol") = True
    myNewRow("TimeSpanCol") = New TimeSpan(10,22,10,15,100)
    myNewRow("DateTimeCol") = System.DateTime.Today
    myNewRow("DecimalCol") = 64.0021
    myNewRow("ByteArrayCol") = New [Byte]() {1, 5, 120}
    myTable.Rows.Add(myNewRow)
    MakeDataTable = myTable  
 End Function

Poznámky

DataType Nastavení hodnoty je velmi důležité k zajištění správného vytváření a aktualizace dat ve zdroji dat.

Vlastnost DataType podporuje následující základní datové typy rozhraní .NET Framework:

a také následující typ pole:

Byte[]

Při změně této vlastnosti se po zahájení ukládání dat ve sloupci vygeneruje výjimka.

Pokud AutoIncrement je nastavena na true před nastavením DataType vlastnosti a pokusíte se nastavit typ na cokoli kromě celočíselného typu, vygeneruje se výjimka.

Poznámka

Sloupec datového typu Byte[] vyžaduje zvláštní zacházení v určitých případech, protože na rozdíl od základních datových typů rozhraní .NET Framework se jedná o referenční datový typ. Pokud se sloupec datového typu Byte[] používá jako PrimaryKeysloupec nebo jako Sort RowFilter klíč pro DataViewhodnotu sloupce, musí jakákoli změna hodnoty sloupce zahrnovat přiřazení Byte[] hodnoty sloupce k samostatnému objektu instance Byte[] . Toto přiřazení se vyžaduje k aktivaci aktualizace interních indexů používaných řazením, filtrováním a operacemi primárního klíče. To je znázorněno v následujícím příkladu:

byte[] columnValue = (byte[])myDataTable.Rows[0][0];  
byte[] newValue = (byte[])columnValue.Clone();  
newValue[1] = 2;  
myDataTable.Rows[0][0] = newValue;

Poznámka

I když je možné definovat sloupec jako datový typ jiný než základní datové typy rozhraní .NET Framework a Byte[], takový sloupec bude považován za uživatelem definovaný typ, s výhradou následujících omezení použití. (Další informace o uživatelem definovaných typech najdete v tématu Vytváření a používání typů User-Defined)

Sloupec nemůže být součástí nebo Select výrazuRowFilter.
Pokud se sloupec používá jako PrimaryKeypole nebo jako nebo Sort pro něj DataView, musí být považováno za neměnné pole. Data sloupce se nesmí po přidání do tabulky změnit.
Jeho ColumnMapping lze nastavit pouze na MappingType.Element.
Třída, která implementuje datový typ sloupce, musí být označena SerializableAttributepomocí , a v případě potřeby implementovat ISerializable nebo IXmlSerializable rozhraní.
Podpora sledování změn je omezená. Aby bylo možné využít DataTable mechanismus sledování změn třídy, třída, která implementuje datový typ sloupce, musí buď implementovat IChangeTracking rozhraní, nebo převzít odpovědnost za informování DataRow o tom, kdy byla hodnota sloupce změněna, buď voláním SetModified na řádek, nebo přiřazením objektu hodnoty sloupce k objektu samostatné instance hodnoty sloupce objektu.

Platí pro