DataColumnCollection.Add Método

Definição

Namespace:: System.Data

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria e adiciona um DataColumn objeto ao DataColumnCollection.

Sobrecargas

Nome	Description
Add()	Cria e adiciona um DataColumn objeto ao DataColumnCollection.
Add(DataColumn)	Cria e adiciona o objeto especificado DataColumn ao DataColumnCollection.
Add(String)	Cria e adiciona um DataColumn objeto que tem o nome especificado ao DataColumnCollection.
Add(String, Type)	Cria e adiciona um DataColumn objeto que tem o nome e o tipo especificados DataColumnCollectionao .
Add(String, Type, String)	Cria e adiciona um DataColumn objeto que tem o nome, o tipo e a expressão especificados DataColumnCollectionao .

Add()

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

Retornos

DataColumn

O recém-criado DataColumn.

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 CollectionChanged evento ocorrerá.

Confira também

Aplica-se a

Add(DataColumn)

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 para adicionar.

Exceções

ArgumentNullException

O column parâmetro é 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. Consulte a Expression propriedade para obter mais informações sobre como criar expressões.

Exemplos

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

Confira também

Aplica-se a

Add(String)

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

Parâmetros

columnName: String

O nome da coluna.

Retornos

DataColumn

O recém-criado DataColumn.

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, a DataType 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 CollectionChanged evento ocorrerá.

Confira também

Aplica-se a

Add(String, Type)

Cria e adiciona um DataColumn objeto que tem o nome e o tipo especificados DataColumnCollectionao .

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

Parâmetros

columnName: String

O ColumnName a ser usado quando você cria a coluna.

type: Type

A DataType da nova coluna.

Retornos

DataColumn

O recém-criado DataColumn.

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. Consulte a Expression propriedade para obter mais informações sobre como criar expressões.

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 CollectionChanged evento ocorrerá.

Confira também

Aplica-se a

Add(String, Type, String)

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

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

Parâmetros

columnName: String

O nome a ser usado ao criar a coluna.

type: Type

A DataType da nova coluna.

expression: String

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

Retornos

DataColumn

O recém-criado DataColumn.

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. Consulte a Expression propriedade para obter mais informações sobre como criar expressões.

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 CollectionChanged evento ocorrerá.

Confira também

Aplica-se a

Comentários

Esta página foi útil?