DataColumn, classe (System.Data)

DataColumn est le bloc de construction autour duquel s'articule la création du schéma de DataTable. Vous pouvez construire le schéma en ajoutant un ou plusieurs objets DataColumn à DataColumnCollection. Pour plus d'informations, consultez Ajout de colonnes à un DataTable (ADO.NET).

Chaque DataColumn possède une propriété DataType qui détermine le type de données contenues dans le DataColumn. Par exemple, vous pouvez restreindre le type de données à des entiers, des chaînes ou des décimales. Comme les données contenues dans le DataTable sont généralement refusionnées dans leur source de données d'origine, vous devez faire correspondre les types de données avec ceux de la source de données. Pour plus d'informations, consultez Mappages de types de données dans ADO.NET.

Les propriétés, telles que AllowDBNull, Unique et ReadOnly imposent des restrictions à l'entrée et à la mise à jour des données, afin de préserver leur intégrité. Vous pouvez également utiliser les propriétés AutoIncrement, AutoIncrementSeed et AutoIncrementStep pour contrôler la génération automatique de données. Pour plus d'informations sur les colonnes AutoIncrement, consultez Création de colonnes AutoIncrement (ADO.NET). Pour plus d'informations, consultez Définition des clés primaires (ADO.NET).

Vous pouvez également garantir que les valeurs de DataColumn sont uniques en créant un UniqueConstraint et en l'ajoutant au ConstraintCollection du DataTable auquel appartient DataColumn. Pour plus d'informations, consultez Contraintes DataTable (ADO.NET).

Pour créer une relation entre les objets DataColumn, créez un objet DataRelation et ajoutez-le au DataRelationCollection de DataSet.

Vous pouvez utiliser la propriété Expression de l'objet DataColumn pour calculer les valeurs d'une colonne ou créer une colonne agrégat. Pour plus d'informations, consultez Création de colonnes d'expression (ADO.NET).

L'exemple suivant crée un DataTable comprenant plusieurs objets DataColumn.

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

    ' Create a DataColumn and set various properties. 
    Dim column As DataColumn = 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

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); 
    } 
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Ce type est sécurisé pour les opérations de lecture multithread. Vous devez synchroniser les opérations d'écriture.

Référence

Autres ressources