DataColumnCollection.Add Méthode

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Crée et ajoute un objet DataColumn à DataColumnCollection.

Surcharges

Add()	Crée et ajoute un objet DataColumn à DataColumnCollection.
Add(DataColumn)	Crée et ajoute l'objet DataColumn spécifié à DataColumnCollection.
Add(String)	Crée et ajoute un objet DataColumn portant le nom spécifié à DataColumnCollection.
Add(String, Type)	Crée et ajoute un objet DataColumn portant le nom et le type spécifiés à DataColumnCollection.
Add(String, Type, String)	Crée et ajoute un objet DataColumn portant le nom, le type et l'expression spécifiés à DataColumnCollection.

Add()

Source:

DataColumnCollection.cs

Crée et ajoute un objet DataColumn à DataColumnCollection.

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

public System.Data.DataColumn Add ();

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

Public Function Add () As DataColumn

Retours

DataColumn

Objet DataColumn nouvellement créé.

Exemples

L’exemple suivant crée et ajoute un nouveau DataColumn au DataColumnCollection d’un 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 », etc.) 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

• ColumnName
• Contains(String)
• DataType
• Expression

Add(DataColumn)

Source:

DataColumnCollection.cs

Crée et ajoute l'objet DataColumn spécifié à 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 paramètre column a la valeur null.

ArgumentException

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

DuplicateNameException

La collection possède déjà une colonne portant le nom spécifié. (La comparaison ne respecte pas la casse.)

InvalidExpressionException

L'expression n'est pas valide. Consultez la propriété Expression pour plus d'informations sur la création d'expressions.

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

• ColumnName
• CollectionChanged
• Contains(String)
• DataType
• Expression

Add(String)

Source:

DataColumnCollection.cs

Crée et ajoute un objet DataColumn portant le nom spécifié à DataColumnCollection.

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

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

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

Public Function Add (columnName As String) As DataColumn

Paramètres

columnName

String

Nom de la colonne.

Retours

DataColumn

Objet DataColumn nouvellement créé.

Exceptions

DuplicateNameException

La collection possède déjà une colonne portant le nom spécifié. (La comparaison ne respecte pas la casse.)

Exemples

L’exemple suivant crée et ajoute un nouveau DataColumn à un DataColumnCollection d’un 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("Total")

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

Remarques

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

Si null ou une chaîne vide («  ») est passée pour le nom, un nom par défaut (« Column1 », « Column2 », etc.) est donné à 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

• ColumnName
• Contains(String)
• DataType
• Expression

Add(String, Type)

Source:

DataColumnCollection.cs

Crée et ajoute un objet DataColumn portant le nom et le type spécifiés à DataColumnCollection.

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

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

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

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

Paramètres

columnName

String

ColumnName à utiliser lors de la création de la colonne.

type

Type

DataType de la nouvelle colonne.

Retours

DataColumn

Objet DataColumn nouvellement créé.

Exceptions

DuplicateNameException

La collection possède déjà une colonne portant le nom spécifié. (La comparaison ne respecte pas la casse.)

InvalidExpressionException

L'expression n'est pas valide. Consultez la propriété Expression pour plus d'informations sur la création d'expressions.

Exemples

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

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 », etc.) est donné à 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

• ColumnName
• DataType
• Expression

Add(String, Type, String)

Source:

DataColumnCollection.cs

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

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

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

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

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

Paramètres

columnName

String

Nom à utiliser lors de la création de la colonne.

type

Type

DataType de la nouvelle colonne.

expression

String

Expression à assigner à la propriété Expression.

Retours

DataColumn

Objet DataColumn nouvellement créé.

Exceptions

DuplicateNameException

La collection possède déjà une colonne portant le nom spécifié. (La comparaison ne respecte pas la casse.)

InvalidExpressionException

L'expression n'est pas valide. Consultez la propriété Expression pour plus d'informations sur la création d'expressions.

Exemples

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

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 », etc.) est donné à 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

• ColumnName
• Contains(String)
• DataType
• Expression