Partager via

DataColumnCollection.Add Méthode

  • Référence

Définition

Espace de noms:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.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
Source:
DataColumnCollection.cs
Source:
DataColumnCollection.cs

Crée et ajoute un objet DataColumn à DataColumnCollection.

public:
 System::Data::DataColumn ^ Add();
public:
 virtual System::Data::DataColumn ^ Add();
public System.Data.DataColumn Add ();
public virtual System.Data.DataColumn Add ();
member this.Add : unit -> System.Data.DataColumn
abstract member Add : unit -> System.Data.DataColumn
override this.Add : unit -> System.Data.DataColumn
Public Function Add () As DataColumn
Public Overridable 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

S’applique à

Add(DataColumn)

Source:
DataColumnCollection.cs
Source:
DataColumnCollection.cs
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

S’applique à

Add(String)

Source:
DataColumnCollection.cs
Source:
DataColumnCollection.cs
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:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName);
public System.Data.DataColumn Add (string? columnName);
public System.Data.DataColumn Add (string columnName);
public virtual System.Data.DataColumn Add (string columnName);
member this.Add : string -> System.Data.DataColumn
abstract member Add : string -> System.Data.DataColumn
override this.Add : string -> System.Data.DataColumn
Public Function Add (columnName As String) As DataColumn
Public Overridable 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

S’applique à

Add(String, Type)

Source:
DataColumnCollection.cs
Source:
DataColumnCollection.cs
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:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);
public System.Data.DataColumn Add (string? columnName, Type type);
public System.Data.DataColumn Add (string columnName, Type type);
public virtual System.Data.DataColumn Add (string columnName, Type type);
member this.Add : string * Type -> System.Data.DataColumn
abstract member Add : string * Type -> System.Data.DataColumn
override this.Add : string * Type -> System.Data.DataColumn
Public Function Add (columnName As String, type As Type) As DataColumn
Public Overridable 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

S’applique à

Add(String, Type, String)

Source:
DataColumnCollection.cs
Source:
DataColumnCollection.cs
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:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);
public System.Data.DataColumn Add (string? columnName, Type type, string expression);
public System.Data.DataColumn Add (string columnName, Type type, string expression);
public virtual System.Data.DataColumn Add (string columnName, Type type, string expression);
member this.Add : string * Type * string -> System.Data.DataColumn
abstract member Add : string * Type * string -> System.Data.DataColumn
override this.Add : string * Type * string -> System.Data.DataColumn
Public Function Add (columnName As String, type As Type, expression As String) As DataColumn
Public Overridable 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

S’applique à