Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

DataColumn classe

 

Date de publication : novembre 2016

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

NomDescription
System_CAPS_pubmethodDataColumn()

Initialise une nouvelle instance d’un DataColumn classe en tant que type chaîne.

System_CAPS_pubmethodDataColumn(String)

Initialise une nouvelle instance de la DataColumn classe, en tant que type chaîne, en utilisant le nom de la colonne spécifiée.

System_CAPS_pubmethodDataColumn(String, Type)

Initialise une nouvelle instance de la DataColumn classe en utilisant le type de données et de nom de colonne spécifié.

System_CAPS_pubmethodDataColumn(String, Type, String)

Initialise une nouvelle instance de la DataColumn classe en utilisant le nom spécifié, le type de données et l’expression.

System_CAPS_pubmethodDataColumn(String, Type, String, MappingType)

Initialise une nouvelle instance de la DataColumn à l’aide du nom, type de données, expression et valeur qui détermine si la colonne est un attribut de classe.

NomDescription
System_CAPS_pubpropertyAllowDBNull

Obtient ou définit une valeur qui indique si les valeurs null sont autorisées dans cette colonne pour les lignes qui appartiennent à la table.

System_CAPS_pubpropertyAutoIncrement

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.

System_CAPS_pubpropertyAutoIncrementSeed

Obtient ou définit la valeur de départ pour une colonne qui a son AutoIncrement propriété true. La valeur par défaut est 0.

System_CAPS_pubpropertyAutoIncrementStep

Obtient ou définit l’incrément utilisé par une colonne avec son AutoIncrement propriété true.

System_CAPS_pubpropertyCaption

Obtient ou définit la légende de la colonne.

System_CAPS_pubpropertyColumnMapping

Obtient ou définit le MappingType de la colonne.

System_CAPS_pubpropertyColumnName

Obtient ou définit le nom de la colonne dans la DataColumnCollection.

System_CAPS_pubpropertyContainer

Obtient le conteneur du composant.(Hérité de MarshalByValueComponent.)

System_CAPS_pubpropertyDataType

Obtient ou définit le type de données stockées dans la colonne.

System_CAPS_pubpropertyDateTimeMode

Obtient ou définit le DateTimeMode pour la colonne.

System_CAPS_pubpropertyDefaultValue

Obtient ou définit la valeur par défaut pour la colonne lorsque vous créez de nouvelles lignes.

System_CAPS_pubpropertyDesignMode

Obtient une valeur indiquant si le composant est actuellement en mode Création.(Hérité de MarshalByValueComponent.)

System_CAPS_protpropertyEvents

Obtient la liste des gestionnaires d’événements attachés à ce composant.(Hérité de MarshalByValueComponent.)

System_CAPS_pubpropertyExpression

Obtient ou définit l’expression utilisée pour filtrer les lignes, de calculer les valeurs dans une colonne ou de créer une colonne d’agrégation.

System_CAPS_pubpropertyExtendedProperties

Obtient la collection d’informations utilisateur personnalisées associées à un DataColumn.

System_CAPS_pubpropertyMaxLength

Obtient ou définit la longueur maximale d’une colonne de texte.

System_CAPS_pubpropertyNamespace

Obtient ou définit l’espace de noms de la DataColumn.

System_CAPS_pubpropertyOrdinal

Obtient la position (de base zéro) de la colonne dans la DataColumnCollection collection.

System_CAPS_pubpropertyPrefix

Obtient ou définit un document XML qui associe un alias de préfixe l’espace de noms de la DataTable.

System_CAPS_pubpropertyReadOnly

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.

System_CAPS_pubpropertySite

Obtient ou définit le site du composant.(Hérité de MarshalByValueComponent.)

System_CAPS_pubpropertyTable

Obtient le DataTable à laquelle la colonne appartient.

System_CAPS_pubpropertyUnique

Obtient ou définit une valeur qui indique si les valeurs de chaque ligne de la colonne doivent être uniques.

NomDescription
System_CAPS_protmethodCheckNotAllowNull()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Ce membre prend en charge l'infrastructure .NET Framework et n'est pas destiné à être utilisé directement à partir de votre code.

System_CAPS_protmethodCheckUnique()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Ce membre prend en charge l'infrastructure .NET Framework et n'est pas destiné à être utilisé directement à partir de votre code.

System_CAPS_pubmethodDispose()

Libère toutes les ressources utilisées par MarshalByValueComponent.(Hérité de MarshalByValueComponent.)

System_CAPS_protmethodDispose(Boolean)

Libère les ressources non managées utilisées par MarshalByValueComponent et libère éventuellement les ressources managées.(Hérité de MarshalByValueComponent.)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de MarshalByValueComponent.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetService(Type)

Obtient l’implémenteur de le IServiceProvider.(Hérité de MarshalByValueComponent.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodOnPropertyChanging(PropertyChangedEventArgs)

Ce membre prend en charge l'infrastructure .NET Framework et n'est pas destiné à être utilisé directement à partir de votre code.

System_CAPS_protmethodRaisePropertyChanging(String)

Ce membre prend en charge l'infrastructure .NET Framework et n'est pas destiné à être utilisé directement à partir de votre code.

System_CAPS_pubmethodSetOrdinal(Int32)

Remplace l’ordinal ou la position de la DataColumn à l’ordinal spécifié ou une position.

System_CAPS_pubmethodToString()

Obtient le Expression de la colonne, le cas échéant.(Remplace MarshalByValueComponent.ToString().)

NomDescription
System_CAPS_pubeventDisposed

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

Le DataColumn est le 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 des objets dans le DataColumnCollection. Pour plus d'informations, consultez Ajout de colonnes à un DataTable.

Chaque DataColumn possède un DataType propriété qui détermine le type de données le DataColumn contient. 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 dans le DataTable est fusionnée généralement dans sa source de données d’origine, vous devez faire correspondre les types de données à celles de la source de données. Pour plus d'informations, consultez Mappages de types de données dans ADO.NET.

Propriétés, telles que AllowDBNull, Unique, et ReadOnly imposent des restrictions à l’entrée et la mise à jour de données, contribuant ainsi à garantir l’intégrité des données. Vous pouvez également utiliser le AutoIncrement, AutoIncrementSeed, et AutoIncrementStep pour contrôler la génération automatique de données. Pour plus d’informations sur AutoIncrement colonnes, consultez Création de colonnes AutoIncrement. Pour plus d'informations, consultez Définition des clés primaires.

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

Pour créer une relation entre DataColumn créer des objets, un DataRelation de l’objet et l’ajouter à la DataRelationCollection d’un DataSet.

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

L’exemple suivant crée un DataTable à 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); 
    } 
}

.NET Framework
Disponible depuis 1.1

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

Retour au début
Afficher: