DataColumnCollection.Add Método

Definição

Espaço de Nomes:: System.Data

Assemblagens:: netstandard.dll, System.Data.Common.dll

Assemblagem:: System.Data.Common.dll

Assemblagem:: System.Data.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Cria e adiciona um DataColumn objeto ao DataColumnCollection.

Sobrecargas

Name	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 tipo especificados ao DataColumnCollection.
Add(String, Type, String)	Cria e adiciona um DataColumn objeto que tem o nome, tipo e expressão especificados ao DataColumnCollection.

Add()

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

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

Devoluções

DataColumn

O recém-criado DataColumn.

Exemplos

O exemplo seguinte 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

Observações

Um nome padrão ("Column1", "Column2", e assim sucessivamente) é atribuído à coluna.

Se a coleção for alterada com sucesso através da adição ou remoção de colunas, o CollectionChanged evento ocorre.

Ver também

Aplica-se a

Add(DataColumn)

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

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 acrescentar.

Exceções

ArgumentNullException

O column parâmetro é null.

ArgumentException

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

DuplicateNameException

A coleção já tem uma coluna com o nome especificado. (A comparação não é sensível a maiúsculas e maiúsculas.)

InvalidExpressionException

A expressão é inválida. Consulte a Expression propriedade para mais informações sobre como criar expressões.

Exemplos

O exemplo seguinte acrescenta a 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

Observações

Se a coleção for alterada com sucesso através da adição ou remoção de colunas, o CollectionChanged evento ocorre.

Ver também

Aplica-se a

Add(String)

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

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

Devoluções

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 é sensível a maiúsculas e maiúsculas.)

Exemplos

O exemplo seguinte 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

Observações

Por defeito, o DataType para a nova coluna é string.

Se null ou uma cadeia vazia ("") for passada para o nome, é atribuído um nome padrão ("Column1", "Column2", etc.) à 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 sucesso através da adição ou remoção de colunas, o CollectionChanged evento ocorre.

Ver também

Aplica-se a

Add(String, Type)

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

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

A usar ColumnName quando crias a coluna.

type: Type

A DataType da nova coluna.

Devoluções

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 é sensível a maiúsculas e maiúsculas.)

InvalidExpressionException

A expressão é inválida. Consulte a Expression propriedade para mais informações sobre como criar expressões.

Exemplos

O exemplo seguinte 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

Observações

Se null ou uma cadeia vazia ("") for passada para o nome, é atribuído um nome padrão ("Column1", "Column2", etc.) à 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 sucesso através da adição ou remoção de colunas, o CollectionChanged evento ocorre.

Ver também

Aplica-se a

Add(String, Type, String)

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

Origem:: DataColumnCollection.cs

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

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members might be trimmed for some data types or expressions.")]
public System.Data.DataColumn Add(string? columnName, Type type, 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);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members might be trimmed for some data types or expressions.")>]
member this.Add : string * Type * string -> System.Data.DataColumn

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 usar quando criar a coluna.

type: Type

A DataType da nova coluna.

expression: String

A expressão a atribuir à Expression propriedade.

Devoluções

DataColumn

O recém-criado DataColumn.

Atributos: RequiresUnreferencedCodeAttribute

Exceções

DuplicateNameException

A coleção já tem uma coluna com o nome especificado. (A comparação não é sensível a maiúsculas e maiúsculas.)

InvalidExpressionException

A expressão é inválida. Consulte a Expression propriedade para mais informações sobre como criar expressões.

Exemplos

O exemplo seguinte 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

Observações

Se null ou uma cadeia vazia ("") for passada para o nome, é atribuído um nome padrão ("Column1", "Column2", etc.) à 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 sucesso através da adição ou remoção de colunas, o CollectionChanged evento ocorre.

Ver também

Aplica-se a

Comentários

Esta página foi útil?