DataColumn Classe

Définition

Représente le schéma d'une colonne dans un DataTable.Represents the schema of a column in a DataTable.

public ref class DataColumn : System::ComponentModel::MarshalByValueComponent
public class DataColumn : System.ComponentModel.MarshalByValueComponent
type DataColumn = class
    inherit MarshalByValueComponent
Public Class DataColumn
Inherits MarshalByValueComponent
Héritage

Exemples

L’exemple suivant crée un DataTable avec plusieurs objets DataColumn.The following example creates a DataTable with several DataColumn objects.

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

Le DataColumn est le bloc de construction fondamental pour la création du schéma d’une DataTable.The DataColumn is the fundamental building block for creating the schema of a DataTable. Vous générez le schéma en ajoutant un ou plusieurs objets DataColumn au DataColumnCollection.You build the schema by adding one or more DataColumn objects to the DataColumnCollection. Pour plus d’informations, consultez Ajout de colonnes à un DataTable.For more information, see Adding Columns to a DataTable.

Chaque DataColumn a une propriété DataType qui détermine le type de données que le DataColumn contient.Each DataColumn has a DataType property that determines the kind of data the DataColumn contains. Par exemple, vous pouvez restreindre le type de données aux entiers, aux chaînes ou aux décimales.For example, you can restrict the data type to integers, or strings, or decimals. Étant donné que les données contenues dans le DataTable sont généralement fusionnées dans la source de données d’origine, vous devez faire correspondre les types de données à ceux de la source de données.Because data that is contained by the DataTable is typically merged back into its original data source, you must match the data types to those in the data source. Pour plus d’informations, consultez mappages de types de données dans ADO.net.For more information, see Data Type Mappings in ADO.NET.

Les propriétés telles que AllowDBNull, Uniqueet ReadOnly placent des restrictions sur l’entrée et la mise à jour des données, ce qui contribue à garantir l’intégrité des données.Properties such as AllowDBNull, Unique, and ReadOnly put restrictions on the entry and updating of data, thereby helping to guarantee data integrity. Vous pouvez également utiliser les propriétés AutoIncrement, AutoIncrementSeedet AutoIncrementStep pour contrôler la génération automatique de données.You can also use the AutoIncrement, AutoIncrementSeed, and AutoIncrementStep properties to control automatic data generation. Pour plus d’informations sur les colonnes de AutoIncrement, consultez Creating AutoIncrement Columns.For more information about AutoIncrement columns, see Creating AutoIncrement Columns. Pour plus d’informations, consultez définition des clés primaires.For more information, see Defining Primary Keys.

Vous pouvez également vous assurer que les valeurs d’un DataColumn sont uniques en créant un UniqueConstraint et en l’ajoutant à la ConstraintCollection du DataTable auquel appartient l' DataColumn.You can also make sure that values in a DataColumn are unique by creating a UniqueConstraint and adding it to the ConstraintCollection of the DataTable to which the DataColumn belongs. Pour plus d’informations, consultez contraintes de DataTable.For more information, see DataTable Constraints.

Pour créer une relation entre des objets DataColumn, créez un objet DataRelation et ajoutez-le à la DataRelationCollection d’un DataSet.To create a relation between DataColumn objects, create a DataRelation object and add it to the DataRelationCollection of a DataSet.

Vous pouvez utiliser la propriété Expression de l’objet DataColumn pour calculer les valeurs d’une colonne, ou créer une colonne d’agrégation.You can use the Expression property of the DataColumn object to calculate the values in a column, or create an aggregate column. Pour plus d’informations, consultez création de colonnes d’expression.For more information, see Creating Expression Columns.

Constructeurs

DataColumn()

Initialise une nouvelle instance d'une classe DataColumn comme chaîne de type.Initializes a new instance of a DataColumn class as type string.

DataColumn(String)

Initialise une nouvelle instance de la classe DataColumn, comme chaîne de type, à l'aide du nom de colonne spécifié.Initializes a new instance of the DataColumn class, as type string, using the specified column name.

DataColumn(String, Type)

Initialise une nouvelle instance de la classe DataColumn à l'aide du nom de colonne et du type de données spécifiés.Initializes a new instance of the DataColumn class using the specified column name and data type.

DataColumn(String, Type, String)

Initialise une nouvelle instance de la classe DataColumn à l'aide du nom, du type de données et de l'expression spécifiés.Initializes a new instance of the DataColumn class using the specified name, data type, and expression.

DataColumn(String, Type, String, MappingType)

Initialise une nouvelle instance de la classe DataColumn à l'aide du nom, du type de données et de l'expression spécifiés, ainsi que d'une valeur qui détermine si la colonne est un attribut.Initializes a new instance of the DataColumn class using the specified name, data type, expression, and value that determines whether the column is an attribute.

Propriétés

AllowDBNull

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.Gets or sets a value that indicates whether null values are allowed in this column for rows that belong to the 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.Gets or sets a value that indicates whether the column automatically increments the value of the column for new rows added to the table.

AutoIncrementSeed

Obtient ou définit la valeur de départ d'une colonne ayant la valeur AutoIncrement affectée à sa propriété true.Gets or sets the starting value for a column that has its AutoIncrement property set to true. La valeur par défaut est 0.The default is 0.

AutoIncrementStep

Obtient ou définit l'incrément utilisé par une colonne ayant la valeur AutoIncrement affectée à sa propriété true.Gets or sets the increment used by a column with its AutoIncrement property set to true.

Caption

Obtient ou définit la légende de la colonne.Gets or sets the caption for the column.

ColumnMapping

Obtient ou définit le MappingType de la colonne.Gets or sets the MappingType of the column.

ColumnName

Obtient ou définit le nom de la colonne dans le DataColumnCollection.Gets or sets the name of the column in the DataColumnCollection.

Container

Obtient le conteneur du composant.Gets the container for the component.

(Hérité de MarshalByValueComponent)
DataType

Obtient ou définit le type de données stockées dans la colonne.Gets or sets the type of data stored in the column.

DateTimeMode

Obtient ou définit le DateTimeMode de la colonne.Gets or sets the DateTimeMode for the column.

DefaultValue

Obtient ou définit la valeur par défaut de la colonne lorsque vous créez de nouvelles lignes.Gets or sets the default value for the column when you are creating new rows.

DesignMode

Obtient une valeur indiquant si le composant est actuellement en mode design.Gets a value indicating whether the component is currently in design mode.

(Hérité de MarshalByValueComponent)
Events

Obtient la liste des gestionnaires d'événements attachés à ce composant.Gets the list of event handlers that are attached to this component.

(Hérité de MarshalByValueComponent)
Expression

Obtient ou définit l'expression utilisée pour filtrer des lignes, calculer les valeurs d'une colonne ou créer une colonne agrégat.Gets or sets the expression used to filter rows, calculate the values in a column, or create an aggregate column.

ExtendedProperties

Obtient la collection d'informations utilisateur personnalisées associée à DataColumn.Gets the collection of custom user information associated with a DataColumn.

MaxLength

Obtient ou définit la longueur maximale d'une colonne de texte.Gets or sets the maximum length of a text column.

Namespace

Obtient ou définit l'espace de noms de DataColumn.Gets or sets the namespace of the DataColumn.

Ordinal

Obtient la position (de base zéro) de la colonne dans la collection DataColumnCollection.Gets the (zero-based) position of the column in the DataColumnCollection collection.

Prefix

Obtient ou définit un préfixe XML qui associe un alias à l'espace de noms de DataTable.Gets or sets an XML prefix that aliases the namespace of the 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.Gets or sets a value that indicates whether the column allows for changes as soon as a row has been added to the table.

Site

Obtient ou définit le site du composant.Gets or sets the site of the component.

(Hérité de MarshalByValueComponent)
Table

Obtient le DataTable auquel la colonne appartient.Gets the DataTable to which the column belongs to.

Unique

Obtient ou définit une valeur qui indique si les valeurs de chaque ligne de la colonne doivent être uniques.Gets or sets a value that indicates whether the values in each row of the column must be unique.

Méthodes

CheckNotAllowNull()

Ce membre prend en charge l'infrastructure .NET Framework et n'est pas destiné à être utilisé directement à partir de votre code.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

CheckUnique()

Ce membre prend en charge l'infrastructure .NET Framework et n'est pas destiné à être utilisé directement à partir de votre code.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Dispose()

Libère toutes les ressources utilisées par MarshalByValueComponent.Releases all resources used by the MarshalByValueComponent.

(Hérité de MarshalByValueComponent)
Dispose(Boolean)

Libère les ressources non managées utilisées par MarshalByValueComponent et libère éventuellement les ressources managées.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

(Hérité de MarshalByValueComponent)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetService(Type)

Obtient l'implémenteur du IServiceProvider.Gets the implementer of the IServiceProvider.

(Hérité de MarshalByValueComponent)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnPropertyChanging(PropertyChangedEventArgs)

Ce membre prend en charge l'infrastructure .NET Framework et n'est pas destiné à être utilisé directement à partir de votre code.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

RaisePropertyChanging(String)

Ce membre prend en charge l'infrastructure .NET Framework et n'est pas destiné à être utilisé directement à partir de votre code.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

SetOrdinal(Int32)

Remplace l'ordinal ou la position du DataColumn par l'ordinal ou la position spécifié(e).Changes the ordinal or position of the DataColumn to the specified ordinal or position.

ToString()

Obtient le Expression éventuel de la colonne.Gets the Expression of the column, if one exists.

Événements

Disposed

Ajoute un gestionnaire d'événements qui doit écouter l'événement Disposed pour le composant.Adds an event handler to listen to the Disposed event on the component.

(Hérité de MarshalByValueComponent)

S’applique à

Cohérence de thread

Ce type est sécurisé pour les opérations de lecture multithread.This type is safe for multithreaded read operations. Vous devez synchroniser toutes les opérations d’écriture.You must synchronize any write operations.

Voir aussi