DataColumnCollection.Add Método

Definição

Cria e adiciona um objeto DataColumn ao DataColumnCollection.Creates and adds a DataColumn object to the DataColumnCollection.

Sobrecargas

Add()

Cria e adiciona um objeto DataColumn ao DataColumnCollection.Creates and adds a DataColumn object to the DataColumnCollection.

Add(DataColumn)

Cria e adiciona o objeto especificado DataColumn ao DataColumnCollection.Creates and adds the specified DataColumn object to the DataColumnCollection.

Add(String)

Cria e adiciona um objeto DataColumn que tem o nome especificado ao DataColumnCollection.Creates and adds a DataColumn object that has the specified name to the DataColumnCollection.

Add(String, Type)

Cria e adiciona um objeto DataColumn que tem o nome e tipo especificado ao DataColumnCollection.Creates and adds a DataColumn object that has the specified name and type to the DataColumnCollection.

Add(String, Type, String)

Cria e adiciona um objeto DataColumn que tem o nome, tipo e expressão especificados ao DataColumnCollection.Creates and adds a DataColumn object that has the specified name, type, and expression to the DataColumnCollection.

Add()

Cria e adiciona um objeto DataColumn ao DataColumnCollection.Creates and adds a DataColumn object to the DataColumnCollection.

public:
 virtual System::Data::DataColumn ^ Add();
public virtual System.Data.DataColumn Add ();
abstract member Add : unit -> System.Data.DataColumn
override this.Add : unit -> System.Data.DataColumn
Public Overridable Function Add () As DataColumn

Retornos

O DataColumn recém-criado.The newly created DataColumn.

Exemplos

O exemplo a seguir cria e adiciona um DataColumn novo DataColumnCollection ao de um DataTable.The following example creates and adds a new DataColumn to the DataColumnCollection of a 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

Comentários

Um nome padrão ("Coluna1", "Coluna2" e assim por diante) é fornecido à coluna.A default name ("Column1", "Column2", and so on) is given to the column.

Se a coleção for alterada com êxito adicionando ou removendo colunas, o evento de CollectionChanged ocorrerá.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

Veja também

Add(DataColumn)

Cria e adiciona o objeto especificado DataColumn ao DataColumnCollection.Creates and adds the specified DataColumn object to the 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)

Parâmetros

column
DataColumn

O DataColumn a ser adicionado.The DataColumn to add.

Exceções

O parâmetro column é null.The column parameter is null.

A coluna já pertence a essa coleção ou a outra coleção.The column already belongs to this collection, or to another collection.

A coleção já tem uma coluna com o nome especificado.The collection already has a column with the specified name. (A comparação não diferencia maiúsculas de minúsculas.)(The comparison is not case-sensitive.)

A expressão é inválida.The expression is invalid. Para obter mais informações sobre como criar expressões, consulte a propriedade Expression.See the Expression property for more information about how to create expressions.

Exemplos

O exemplo a seguir adiciona DataColumn um DataColumnCollectiona.The following example adds a DataColumn to a 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

Comentários

Se a coleção for alterada com êxito adicionando ou removendo colunas, o evento de CollectionChanged ocorrerá.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

Veja também

Add(String)

Cria e adiciona um objeto DataColumn que tem o nome especificado ao DataColumnCollection.Creates and adds a DataColumn object that has the specified name to the DataColumnCollection.

public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName);
public virtual System.Data.DataColumn Add (string columnName);
abstract member Add : string -> System.Data.DataColumn
override this.Add : string -> System.Data.DataColumn
Public Overridable Function Add (columnName As String) As DataColumn

Parâmetros

columnName
String

O nome da coluna.The name of the column.

Retornos

O DataColumn recém-criado.The newly created DataColumn.

Exceções

A coleção já tem uma coluna com o nome especificado.The collection already has a column with the specified name. (A comparação não diferencia maiúsculas de minúsculas.)(The comparison is not case-sensitive.)

Exemplos

O exemplo a seguir cria e adiciona um DataColumn novo a DataColumnCollection um de DataTableum.The following example creates and adds a new DataColumn to a DataColumnCollection of a 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

Comentários

Por padrão, o DataType para a nova coluna é string.By default, the DataType for the new column is string.

Se null ou uma cadeia de caracteres vazia ("") for passada para o nome, um nome padrão ("Coluna1", "Coluna2" e assim por diante) será fornecido à coluna.If null or an empty string ("") is passed in for the name, a default name ("Column1", "Column2", and so on) is given to the column.

Use o Contains método para determinar se uma coluna com o nome proposto já existe na coleção.Use the Contains method to determine whether a column with the proposed name already exists in the collection.

Se a coleção for alterada com êxito adicionando ou removendo colunas, o evento de CollectionChanged ocorrerá.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

Veja também

Add(String, Type)

Cria e adiciona um objeto DataColumn que tem o nome e tipo especificado ao DataColumnCollection.Creates and adds a DataColumn object that has the specified name and type to the DataColumnCollection.

public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);
public virtual System.Data.DataColumn Add (string columnName, Type type);
abstract member Add : string * Type -> System.Data.DataColumn
override this.Add : string * Type -> System.Data.DataColumn

Parâmetros

columnName
String

O ColumnName a ser usado ao criar a coluna.The ColumnName to use when you create the column.

type
Type

O DataType da nova coluna.The DataType of the new column.

Retornos

O DataColumn recém-criado.The newly created DataColumn.

Exceções

A coleção já tem uma coluna com o nome especificado.The collection already has a column with the specified name. (A comparação não diferencia maiúsculas de minúsculas.)(The comparison is not case-sensitive.)

A expressão é inválida.The expression is invalid. Para obter mais informações sobre como criar expressões, consulte a propriedade Expression.See the Expression property for more information about how to create expressions.

Exemplos

O exemplo a seguir cria e adiciona um DataColumn novo a DataColumnCollection um de DataTableum.The following example creates and adds a new DataColumn to a DataColumnCollection of a 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

Comentários

Se null ou uma cadeia de caracteres vazia ("") for passada para o nome, um nome padrão ("Coluna1", "Coluna2" e assim por diante) será fornecido à coluna.If null or an empty string ("") is passed in for the name, a default name ("Column1", "Column2", and so on) is given to the column.

Use o Contains método para determinar se uma coluna com o nome proposto já existe na coleção.Use the Contains method to determine whether a column with the proposed name already exists in the collection.

Se a coleção for alterada com êxito adicionando ou removendo colunas, o evento de CollectionChanged ocorrerá.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

Veja também

Add(String, Type, String)

Cria e adiciona um objeto DataColumn que tem o nome, tipo e expressão especificados ao DataColumnCollection.Creates and adds a DataColumn object that has the specified name, type, and expression to the DataColumnCollection.

public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);
public virtual 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

Parâmetros

columnName
String

O nome a ser usado ao criar a coluna.The name to use when you create the column.

type
Type

O DataType da nova coluna.The DataType of the new column.

expression
String

A expressão a ser atribuída à propriedade Expression.The expression to assign to the Expression property.

Retornos

O DataColumn recém-criado.The newly created DataColumn.

Exceções

A coleção já tem uma coluna com o nome especificado.The collection already has a column with the specified name. (A comparação não diferencia maiúsculas de minúsculas.)(The comparison is not case-sensitive.)

A expressão é inválida.The expression is invalid. Para obter mais informações sobre como criar expressões, consulte a propriedade Expression.See the Expression property for more information about how to create expressions.

Exemplos

O exemplo a seguir cria e adiciona um DataColumn novo a DataColumnCollection um de DataTableum.The following example creates and adds a new DataColumn to a DataColumnCollection of a 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

Comentários

Se null ou uma cadeia de caracteres vazia ("") for passada para o nome, um nome padrão ("Coluna1", "Coluna2" e assim por diante) será fornecido à coluna.If null or an empty string ("") is passed in for the name, a default name ("Column1", "Column2", and so on) is given to the column.

Use o Contains método para determinar se uma coluna com o nome proposto já existe na coleção.Use the Contains method to determine whether a column with the proposed name already exists in the collection.

Se a coleção for alterada com êxito adicionando ou removendo colunas, o evento de CollectionChanged ocorrerá.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

Veja também

Aplica-se a