DataColumn, classe

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 Adding Columns to a Table.

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 Mapping .NET Framework Data Provider Data Types to .NET Framework Data Types.

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 Creating AutoIncrement Columns. Pour plus d'informations, consultez Defining a Primary Key for a Table.

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 Adding Constraints to a Table.

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 Creating Expression Columns.

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

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 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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