DataColumn Classe

Définition

Espace de noms:

System.Data

Assemblys:

netstandard.dll, System.Data.Common.dll

Source:

DataColumn.cs

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

public ref class DataColumn : System::ComponentModel::MarshalByValueComponent

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataColumn : System.ComponentModel.MarshalByValueComponent

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataColumn = class
    inherit MarshalByValueComponent

Public Class DataColumn
Inherits MarshalByValueComponent

Héritage

Object

MarshalByValueComponent

DataColumn

Attributs

DynamicallyAccessedMembersAttribute

Exemples

L’exemple suivant crée un DataTable objet avec plusieurs DataColumn objets.

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

Remarques

Il DataColumn s’agit du bloc de construction fondamental pour créer le schéma d’un DataTable. Vous générez le schéma en ajoutant un ou plusieurs DataColumn objets à l’objet DataColumnCollection. Pour plus d’informations, consultez Ajout de colonnes à un DataTable.

Chacun DataColumn a une DataType propriété qui détermine le type de données que contient DataColumn . Par exemple, vous pouvez restreindre le type de données à des entiers, des chaînes ou des décimales. Étant donné que les données contenues par l’élément DataTable sont généralement fusionnées dans sa source de données d’origine, vous devez faire correspondre les types de données à 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, Uniqueet ReadOnly mettent des restrictions sur l’entrée et la mise à jour des données, ce qui contribue à garantir l’intégrité des données. Vous pouvez également utiliser les propriétés et AutoIncrementSeedAutoIncrementStep les AutoIncrementpropriétés pour contrôler la génération automatique de données. Pour plus d’informations sur les AutoIncrement colonnes, consultez Création de colonnes d’autoincrement. Pour plus d’informations, consultez Définition des clés primaires.

Vous pouvez également vous assurer que les valeurs d’un élément DataColumn sont uniques en créant et UniqueConstraint en l’ajoutant à l’élément ConstraintCollectionDataTable auquel appartient le DataColumn membre. Pour plus d’informations, consultez Contraintes DataTable.

Pour créer une relation entre DataColumn les objets, créez un DataRelation objet et ajoutez-le à l’objet DataRelationCollectionDataSet.

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

Constructeurs

Nom	Description
DataColumn()	Initialise une nouvelle instance de la DataColumn classe en tant que chaîne de type.
DataColumn(String, Type, String, MappingType)	Initialise une nouvelle instance de la DataColumn classe à l’aide du nom, du type de données, de l’expression et de la valeur spécifiés qui détermine si la colonne est un attribut.
DataColumn(String, Type, String)	Initialise une nouvelle instance de la classe à l’aide du nom, du type de données et de l’expression DataColumn spécifiés.
DataColumn(String, Type)	Initialise une nouvelle instance de la DataColumn classe à l’aide du nom de colonne et du type de données spécifiés.
DataColumn(String)	Initialise une nouvelle instance de la DataColumn classe, en tant que chaîne de type, à l’aide du nom de colonne spécifié.

Propriétés

Nom	Description
AllowDBNull	Obtient ou définit une valeur qui indique si les valeurs Null sont autorisées dans cette colonne pour les lignes appartenant à la table.
AutoIncrement	Obtient ou définit une valeur qui indique si la colonne incrémente automatiquement la valeur de la colonne pour les nouvelles lignes ajoutées à la table.
AutoIncrementSeed	Obtient ou définit la valeur de départ d’une colonne dont la AutoIncrement propriété est définie truesur . La valeur par défaut est 0.
AutoIncrementStep	Obtient ou définit l’incrément utilisé par une colonne avec sa AutoIncrement propriété définie sur true.
Caption	Obtient ou définit la légende de la colonne.
ColumnMapping	Obtient ou définit la MappingType colonne.
ColumnName	Obtient ou définit le nom de la colonne dans le DataColumnCollection.
Container	Obtient le conteneur du composant. (Hérité de MarshalByValueComponent)
DataType	Obtient ou définit le type de données stockées dans la colonne.
DateTimeMode	Obtient ou définit la DateTimeMode colonne.
DefaultValue	Obtient ou définit la valeur par défaut de la colonne lorsque vous créez de nouvelles lignes.
DesignMode	Obtient une valeur indiquant si le composant est actuellement en mode création. (Hérité de MarshalByValueComponent)
Events	Obtient la liste des gestionnaires d’événements attachés à ce composant. (Hérité de MarshalByValueComponent)
Expression	Obtient ou définit l’expression utilisée pour filtrer les lignes, calculer les valeurs d’une colonne ou créer une colonne d’agrégation.
ExtendedProperties	Obtient la collection d’informations utilisateur personnalisées associées à un DataColumn.
MaxLength	Obtient ou définit la longueur maximale d’une colonne de texte.
Namespace	Obtient ou définit l’espace de noms du DataColumn.
Ordinal	Obtient la position (de base zéro) de la colonne dans la DataColumnCollection collection.
Prefix	Obtient ou définit un préfixe XML qui alias l’espace de noms du DataTable.
ReadOnly	Obtient ou définit une valeur qui indique si la colonne autorise les modifications dès qu’une ligne a été ajoutée à la table.
Site	Obtient ou définit le site du composant. (Hérité de MarshalByValueComponent)
Table	Obtient la DataTable colonne à laquelle appartient la colonne.
Unique	Obtient ou définit une valeur qui indique si les valeurs de chaque ligne de la colonne doivent être uniques.

Méthodes

Nom	Description
CheckNotAllowNull()	Ce membre prend en charge l’infrastructure .NET et n’est pas destiné à être utilisé directement à partir de votre code.
CheckUnique()	Ce membre prend en charge l’infrastructure .NET et n’est pas destiné à être utilisé directement à partir de votre code.
Dispose()	Libère toutes les ressources utilisées par le MarshalByValueComponent. (Hérité de MarshalByValueComponent)
Dispose(Boolean)	Libère les ressources non managées utilisées par les MarshalByValueComponent ressources gérées et libère éventuellement les ressources managées. (Hérité de MarshalByValueComponent)
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetService(Type)	Obtient l’implémenteur du IServiceProvider. (Hérité de MarshalByValueComponent)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnPropertyChanging(PropertyChangedEventArgs)	Ce membre prend en charge l’infrastructure .NET et n’est pas destiné à être utilisé directement à partir de votre code.
RaisePropertyChanging(String)	Ce membre prend en charge l’infrastructure .NET et n’est pas destiné à être utilisé directement à partir de votre code.
SetOrdinal(Int32)	Modifie l’ordinal ou la position de l’ordinal DataColumn ou de la position spécifiée.
ToString()	Obtient la Expression colonne, le cas échéant.

Événements

Nom	Description
Disposed	Ajoute un gestionnaire d’événements pour écouter l’événement Disposed sur le composant. (Hérité de MarshalByValueComponent)

Cohérence de thread

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

Voir aussi

• Add(DataColumn)
• DataColumnCollection
• Constraints
• ConstraintCollection
• DataGrid
• DataRow
• DataTable
• DataSet
• NewRow()
• DataRowCollection
• UniqueConstraint
• Utilisation de DataSets dans ADO.NET