DataColumnCollection.Add Método

  • Referência

Definição

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Cria e adiciona um objeto DataColumn ao DataColumnCollection.

Sobrecargas

Add()

Cria e adiciona um objeto DataColumn ao DataColumnCollection.
Add(DataColumn)

Cria e adiciona o objeto especificado DataColumn ao DataColumnCollection.
Add(String)

Cria e adiciona um objeto DataColumn que tem o nome especificado ao DataColumnCollection.
Add(String, Type)

Cria e adiciona um objeto DataColumn que tem o nome e tipo especificado ao DataColumnCollection.
Add(String, Type, String)

Cria e adiciona um objeto DataColumn que tem o nome, tipo e expressão especificados ao DataColumnCollection.

Add()

Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs

Cria e adiciona um objeto DataColumn ao 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

Retornos

DataColumn

O DataColumn recém-criado.

Exemplos

O exemplo a seguir cria e adiciona um novo DataColumn ao DataColumnCollection de um 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 ("Column1", "Column2" e assim por diante) é fornecido à coluna.

Se a coleção for alterada com êxito adicionando ou removendo colunas, o evento de CollectionChanged ocorrerá.

Confira também

Aplica-se a

Add(DataColumn)

Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs

Cria e adiciona o objeto especificado DataColumn ao 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.

Exceções

ArgumentNullException

O parâmetro column é null.

ArgumentException

A coluna já pertence a essa coleção ou a outra coleção.

DuplicateNameException

A coleção já tem uma coluna com o nome especificado. (A comparação não diferencia maiúsculas de minúsculas.)

InvalidExpressionException

A expressão é inválida. Para obter mais informações sobre como criar expressões, consulte a propriedade Expression.

Exemplos

O exemplo a seguir adiciona um DataColumn a um 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á.

Confira também

Aplica-se a

Add(String)

Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs

Cria e adiciona um objeto DataColumn que tem o nome especificado ao 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

Parâmetros

columnName
String

O nome da coluna.

Retornos

DataColumn

O DataColumn recém-criado.

Exceções

DuplicateNameException

A coleção já tem uma coluna com o nome especificado. (A comparação não diferencia maiúsculas de minúsculas.)

Exemplos

O exemplo a seguir cria e adiciona um novo DataColumn a um DataColumnCollection de um 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.

Se null ou uma cadeia de caracteres vazia ("") for passada para o nome, um nome padrão ("Column1", "Column2" e assim por diante) será fornecido à coluna.

Use o Contains método para determinar se uma coluna com o nome proposto já existe na coleção.

Se a coleção for alterada com êxito adicionando ou removendo colunas, o evento de CollectionChanged ocorrerá.

Confira também

Aplica-se a

Add(String, Type)

Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs

Cria e adiciona um objeto DataColumn que tem o nome e tipo especificado ao 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

Parâmetros

columnName
String

O ColumnName a ser usado ao criar a coluna.

type
Type

O DataType da nova coluna.

Retornos

DataColumn

O DataColumn recém-criado.

Exceções

DuplicateNameException

A coleção já tem uma coluna com o nome especificado. (A comparação não diferencia maiúsculas de minúsculas.)

InvalidExpressionException

A expressão é inválida. Para obter mais informações sobre como criar expressões, consulte a propriedade Expression.

Exemplos

O exemplo a seguir cria e adiciona um novo DataColumn a um DataColumnCollection de um 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 ("Column1", "Column2" e assim por diante) será fornecido à coluna.

Use o Contains método para determinar se uma coluna com o nome proposto já existe na coleção.

Se a coleção for alterada com êxito adicionando ou removendo colunas, o evento de CollectionChanged ocorrerá.

Confira também

Aplica-se a

Add(String, Type, String)

Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs

Cria e adiciona um objeto DataColumn que tem o nome, tipo e expressão especificados ao 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

Parâmetros

columnName
String

O nome a ser usado ao criar a coluna.

type
Type

O DataType da nova coluna.

expression
String

A expressão a ser atribuída à propriedade Expression.

Retornos

DataColumn

O DataColumn recém-criado.

Exceções

DuplicateNameException

A coleção já tem uma coluna com o nome especificado. (A comparação não diferencia maiúsculas de minúsculas.)

InvalidExpressionException

A expressão é inválida. Para obter mais informações sobre como criar expressões, consulte a propriedade Expression.

Exemplos

O exemplo a seguir cria e adiciona um novo DataColumn a um DataColumnCollection de um 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 ("Column1", "Column2" e assim por diante) será fornecido à coluna.

Use o Contains método para determinar se uma coluna com o nome proposto já existe na coleção.

Se a coleção for alterada com êxito adicionando ou removendo colunas, o evento de CollectionChanged ocorrerá.

Confira também

Aplica-se a