DataColumn DataColumn DataColumn DataColumn Class

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 DataColumn objets.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 DataTable = new DataTable("Product") 

    ' Create a DataColumn and set various properties. 
    Dim column As DataColumn = 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

Est le bloc de construction fondamental pour créer le schéma d’un DataTable. DataColumnThe DataColumn is the fundamental building block for creating the schema of a DataTable. Vous générez le schéma en ajoutant un ou DataColumn plusieurs objets 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 DataType propriété qui détermine DataColumn le type de données que 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 DataTable dans le 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 AllowDBNullque Unique, et 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 AutoIncrementpropriétés AutoIncrementSeed, et 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 AutoIncrement sur les colonnes, consultez création de colonnes AutoIncrement.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 DataColumn ConstraintCollection UniqueConstraint DataTable valeursdansunsontuniquesencréantunetenl’ajoutantauDataColumn du auquel appartient.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 DataColumn des objets, créez DataRelation un objet et ajoutez-le DataRelationCollection au d' DataSetun.To create a relation between DataColumn objects, create a DataRelation object and add it to the DataRelationCollection of a DataSet.

Vous pouvez utiliser la Expression propriété de l' DataColumn objet 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() DataColumn() DataColumn() 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) DataColumn(String) DataColumn(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) DataColumn(String, Type) DataColumn(String, Type) 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) DataColumn(String, Type, String) DataColumn(String, Type, String) 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) DataColumn(String, Type, String, MappingType) DataColumn(String, Type, String, MappingType) 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 AllowDBNull AllowDBNull 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 AutoIncrement AutoIncrement 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 AutoIncrementSeed AutoIncrementSeed AutoIncrementSeed

Obtient ou définit la valeur de départ d'une colonne ayant la valeur true affectée à sa propriété AutoIncrement.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 AutoIncrementStep AutoIncrementStep AutoIncrementStep

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

Caption Caption Caption Caption

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

ColumnMapping ColumnMapping ColumnMapping ColumnMapping

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

ColumnName ColumnName ColumnName 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 Container Container Container

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

(Inherited from MarshalByValueComponent)
DataType DataType DataType DataType

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

DateTimeMode DateTimeMode DateTimeMode DateTimeMode

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

DefaultValue DefaultValue DefaultValue 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 DesignMode DesignMode 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.

(Inherited from MarshalByValueComponent)
Events Events Events 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.

(Inherited from MarshalByValueComponent)
Expression Expression Expression 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 ExtendedProperties ExtendedProperties ExtendedProperties

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

MaxLength MaxLength MaxLength MaxLength

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

Namespace Namespace Namespace Namespace

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

Ordinal Ordinal Ordinal 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 Prefix Prefix 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 ReadOnly ReadOnly 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 Site Site Site

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

(Inherited from MarshalByValueComponent)
Table Table Table Table

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

Unique Unique Unique 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() CheckNotAllowNull() CheckNotAllowNull() 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() CheckUnique() CheckUnique() 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() Dispose() Dispose() Dispose()

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

(Inherited from MarshalByValueComponent)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) 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.

(Inherited from MarshalByValueComponent)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

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

(Inherited from MarshalByValueComponent)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) 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) RaisePropertyChanging(String) RaisePropertyChanging(String) 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) SetOrdinal(Int32) SetOrdinal(Int32) 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() ToString() ToString() ToString()

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

Événements

Disposed Disposed Disposed 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.

(Inherited from 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