DataColumnCollection.Add Méthode

Définition

Espace de noms:: System.Data

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Crée et ajoute un DataColumn objet au DataColumnCollection.

Surcharges

Nom	Description
Add()	Crée et ajoute un DataColumn objet au DataColumnCollection.
Add(DataColumn)	Crée et ajoute l’objet spécifié DataColumn à l’objet DataColumnCollection.
Add(String)	Crée et ajoute un DataColumn objet qui a le nom spécifié à l’objet DataColumnCollection.
Add(String, Type)	Crée et ajoute un DataColumn objet qui a le nom et le type spécifiés à l’objet DataColumnCollection.
Add(String, Type, String)	Crée et ajoute un DataColumn objet qui a le nom, le type et l’expression spécifiés à l’objet DataColumnCollection.

Add()

Crée et ajoute un DataColumn objet au DataColumnCollection.

public:
 virtual System::Data::DataColumn ^ Add();

public:
 System::Data::DataColumn ^ Add();

public virtual System.Data.DataColumn Add();

public System.Data.DataColumn Add();

abstract member Add : unit -> System.Data.DataColumn
override this.Add : unit -> System.Data.DataColumn

member this.Add : unit -> System.Data.DataColumn

Public Overridable Function Add () As DataColumn

Public Function Add () As DataColumn

Retours

DataColumn

Nouvellement créé DataColumn.

Exemples

L’exemple suivant crée et ajoute un nouveau DataColumn à l’objet DataColumnCollection DataTable.

Private Sub AddColumn()
    ' Get the DataColumnCollection from a table in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Prices").Columns
    Dim column As DataColumn = columns.Add()

    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ColumnName = "Total"
       .Expression = "UnitPrice * Quantity"
       .ReadOnly = True
       .Unique = False
    End With
End Sub

Remarques

Un nom par défaut (« Column1 », « Column2 », et ainsi de suite) est attribué à la colonne.

Si la collection est correctement modifiée en ajoutant ou en supprimant des colonnes, l’événement CollectionChanged se produit.

Voir aussi

S’applique à

Add(DataColumn)

Crée et ajoute l’objet spécifié DataColumn à l’objet DataColumnCollection.

public:
 void Add(System::Data::DataColumn ^ column);

public void Add(System.Data.DataColumn column);

member this.Add : System.Data.DataColumn -> unit

Public Sub Add (column As DataColumn)

Paramètres

column: DataColumn

À DataColumn ajouter.

Exceptions

ArgumentNullException

Le column paramètre est null.

ArgumentException

La colonne appartient déjà à cette collection ou à une autre collection.

DuplicateNameException

La collection a déjà une colonne portant le nom spécifié. (La comparaison n’est pas sensible à la casse.)

InvalidExpressionException

L’expression n’est pas valide. Pour plus d’informations sur la création d’expressions, consultez la Expression propriété.

Exemples

L’exemple suivant ajoute un DataColumn à un DataColumnCollection.

Private Sub AddDataColumn()
    ' Get the DataColumnCollection from a DataTable in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns
 
    Dim column As New DataColumn()
    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ColumnName = "ItemPrice"
       .Caption = "Price"
       .ReadOnly = False
       .Unique = False
       .DefaultValue = 0
    End With
    columns.Add(column)
End Sub

Remarques

Si la collection est correctement modifiée en ajoutant ou en supprimant des colonnes, l’événement CollectionChanged se produit.

Voir aussi

S’applique à

Add(String)

Crée et ajoute un DataColumn objet qui a le nom spécifié à l’objet DataColumnCollection.

public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName);

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName);

public virtual System.Data.DataColumn Add(string columnName);

public System.Data.DataColumn Add(string columnName);

abstract member Add : string -> System.Data.DataColumn
override this.Add : string -> System.Data.DataColumn

member this.Add : string -> System.Data.DataColumn

Public Overridable Function Add (columnName As String) As DataColumn

Public Function Add (columnName As String) As DataColumn

Paramètres

columnName: String

Nom de la colonne.

Retours

DataColumn

Nouvellement créé DataColumn.

Exceptions

DuplicateNameException

La collection a déjà une colonne portant le nom spécifié. (La comparaison n’est pas sensible à la casse.)

Exemples

L’exemple suivant crée et ajoute un nouveau DataColumn à un DataColumnCollection DataTableobjet .

Private Sub AddColumn()
    ' Get the DataColumnCollection from a table in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Prices").Columns
    Dim column As DataColumn = columns.Add("Total")

    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ReadOnly = True
       .Expression = "UnitPrice * Quantity"
       .Unique = False
    End With
End Sub

Remarques

Par défaut, la DataType nouvelle colonne est string.

Si null ou une chaîne vide (« ») est passée pour le nom, un nom par défaut (« Column1 », « Column2 », et ainsi de suite) est attribué à la colonne.

Utilisez la Contains méthode pour déterminer si une colonne portant le nom proposé existe déjà dans la collection.

Si la collection est correctement modifiée en ajoutant ou en supprimant des colonnes, l’événement CollectionChanged se produit.

Voir aussi

S’applique à

Add(String, Type)

Crée et ajoute un DataColumn objet qui a le nom et le type spécifiés à l’objet DataColumnCollection.

public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);

public virtual System.Data.DataColumn Add(string columnName, Type type);

public System.Data.DataColumn Add(string columnName, Type type);

abstract member Add : string * Type -> System.Data.DataColumn
override this.Add : string * Type -> System.Data.DataColumn

member this.Add : string * Type -> System.Data.DataColumn

Public Overridable Function Add (columnName As String, type As Type) As DataColumn

Public Function Add (columnName As String, type As Type) As DataColumn

Paramètres

columnName: String

À ColumnName utiliser lorsque vous créez la colonne.

type: Type

Nouvelle DataType colonne.

Retours

DataColumn

Nouvellement créé DataColumn.

Exceptions

DuplicateNameException

La collection a déjà une colonne portant le nom spécifié. (La comparaison n’est pas sensible à la casse.)

InvalidExpressionException

L’expression n’est pas valide. Pour plus d’informations sur la création d’expressions, consultez la Expression propriété.

Exemples

L’exemple suivant crée et ajoute un nouveau DataColumn à un DataColumnCollection DataTableobjet .

Private Sub AddColumn()
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns
 
    ' Add a new column and return it.
    Dim column As DataColumn = columns.Add( _
        "Total", System.Type.GetType("System.Decimal"))
    column.ReadOnly = True
    column.Unique = False
End Sub

Remarques

Si null ou une chaîne vide (« ») est passée pour le nom, un nom par défaut (« Column1 », « Column2 », et ainsi de suite) est attribué à la colonne.

Utilisez la Contains méthode pour déterminer si une colonne portant le nom proposé existe déjà dans la collection.

Si la collection est correctement modifiée en ajoutant ou en supprimant des colonnes, l’événement CollectionChanged se produit.

Voir aussi

S’applique à

Add(String, Type, String)

Crée et ajoute un DataColumn objet qui a le nom, le type et l’expression spécifiés à l’objet DataColumnCollection.

public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);

public virtual System.Data.DataColumn Add(string columnName, Type type, string expression);

public System.Data.DataColumn Add(string columnName, Type type, string expression);

abstract member Add : string * Type * string -> System.Data.DataColumn
override this.Add : string * Type * string -> System.Data.DataColumn

member this.Add : string * Type * string -> System.Data.DataColumn

Public Overridable Function Add (columnName As String, type As Type, expression As String) As DataColumn

Public Function Add (columnName As String, type As Type, expression As String) As DataColumn

Paramètres

columnName: String

Nom à utiliser lorsque vous créez la colonne.

type: Type

Nouvelle DataType colonne.

expression: String

Expression à affecter à la Expression propriété.

Retours

DataColumn

Nouvellement créé DataColumn.

Exceptions

DuplicateNameException

La collection a déjà une colonne portant le nom spécifié. (La comparaison n’est pas sensible à la casse.)

InvalidExpressionException

L’expression n’est pas valide. Pour plus d’informations sur la création d’expressions, consultez la Expression propriété.

Exemples

L’exemple suivant crée et ajoute un nouveau DataColumn à un DataColumnCollection DataTableobjet .

Private Sub AddColumn()
    ' Get the DataColumnCollection of a table in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns

    ' Add a new column and return it.
    Dim column As DataColumn = _
        columns.Add("Total", System.Type.GetType( _
        "System.Decimal"), "Price + Tax")
    column.ReadOnly = True
    column.Unique = False
 End Sub

Remarques

Si null ou une chaîne vide (« ») est passée pour le nom, un nom par défaut (« Column1 », « Column2 », et ainsi de suite) est attribué à la colonne.

Utilisez la Contains méthode pour déterminer si une colonne portant le nom proposé existe déjà dans la collection.

Si la collection est correctement modifiée en ajoutant ou en supprimant des colonnes, l’événement CollectionChanged se produit.

Voir aussi

S’applique à

Commentaires

Cette page a-t-elle été utile ?