Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout

DataColumn, classe

Mise à jour : novembre 2007

Représente le schéma d'une colonne dans un DataTable.

Espace de noms :  System.Data
Assembly :  System.Data (dans System.Data.dll)

public class DataColumn : MarshalByValueComponent
public class DataColumn extends MarshalByValueComponent
public class DataColumn extends MarshalByValueComponent

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


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

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC, Xbox 360

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0

XNA Framework

Pris en charge dans : 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft