DataColumnCollection.Add Método

Definición

Espacio de nombres:: System.Data

Ensamblado:: System.Data.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Crea y agrega un DataColumn objeto a .DataColumnCollection

Sobrecargas

Nombre	Description
Add()	Crea y agrega un DataColumn objeto a .DataColumnCollection
Add(DataColumn)	Crea y agrega el objeto especificado DataColumn a .DataColumnCollection
Add(String)	Crea y agrega un DataColumn objeto que tiene el nombre especificado a .DataColumnCollection
Add(String, Type)	Crea y agrega un DataColumn objeto que tiene el nombre y el tipo especificados a .DataColumnCollection
Add(String, Type, String)	Crea y agrega un DataColumn objeto que tiene el nombre, el tipo y la expresión especificados a .DataColumnCollection

Add()

Crea y agrega un DataColumn objeto a .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

Devoluciones

DataColumn

Objeto recién creado DataColumn.

Ejemplos

En el ejemplo siguiente se crea y se agrega un nuevo DataColumn al DataColumnCollection objeto de .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

Comentarios

Se asigna un nombre predeterminado ("Column1", "Column2", etc.) a la columna.

Si la colección cambia correctamente agregando o quitando columnas, se produce el CollectionChanged evento .

Consulte también

Se aplica a

Add(DataColumn)

Crea y agrega el objeto especificado DataColumn a .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

que DataColumn se va a agregar.

Excepciones

ArgumentNullException

El column parámetro es null.

ArgumentException

La columna ya pertenece a esta colección o a otra colección.

DuplicateNameException

La colección ya tiene una columna con el nombre especificado. (La comparación no distingue mayúsculas de minúsculas).

InvalidExpressionException

La expresión no es válida. Consulte la Expression propiedad para obtener más información sobre cómo crear expresiones.

Ejemplos

En el ejemplo siguiente se agrega un DataColumn objeto 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

Comentarios

Si la colección cambia correctamente agregando o quitando columnas, se produce el CollectionChanged evento .

Consulte también

Se aplica a

Add(String)

Crea y agrega un DataColumn objeto que tiene el nombre especificado a .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

Nombre de la columna.

Devoluciones

DataColumn

Objeto recién creado DataColumn.

Excepciones

DuplicateNameException

La colección ya tiene una columna con el nombre especificado. (La comparación no distingue mayúsculas de minúsculas).

Ejemplos

En el ejemplo siguiente se crea y se agrega un nuevo DataColumn a DataColumnCollection un de .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

Comentarios

De forma predeterminada, para DataType la nueva columna es string.

Si null o se pasa una cadena vacía ("") para el nombre, se asigna un nombre predeterminado ("Column1", "Column2", etc.) a la columna.

Use el Contains método para determinar si ya existe una columna con el nombre propuesto en la colección.

Si la colección cambia correctamente agregando o quitando columnas, se produce el CollectionChanged evento .

Consulte también

Se aplica a

Add(String, Type)

Crea y agrega un DataColumn objeto que tiene el nombre y el tipo especificados a .DataColumnCollection

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

que ColumnName se va a usar al crear la columna.

type: Type

DataType de la nueva columna.

Devoluciones

DataColumn

Objeto recién creado DataColumn.

Excepciones

DuplicateNameException

La colección ya tiene una columna con el nombre especificado. (La comparación no distingue mayúsculas de minúsculas).

InvalidExpressionException

La expresión no es válida. Consulte la Expression propiedad para obtener más información sobre cómo crear expresiones.

Ejemplos

En el ejemplo siguiente se crea y se agrega un nuevo DataColumn a DataColumnCollection un de .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

Comentarios

Si null o se pasa una cadena vacía ("") para el nombre, se asigna un nombre predeterminado ("Column1", "Column2", etc.) a la columna.

Use el Contains método para determinar si ya existe una columna con el nombre propuesto en la colección.

Si la colección cambia correctamente agregando o quitando columnas, se produce el CollectionChanged evento .

Consulte también

Se aplica a

Add(String, Type, String)

Crea y agrega un DataColumn objeto que tiene el nombre, el tipo y la expresión especificados a .DataColumnCollection

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

Nombre que se va a usar al crear la columna.

type: Type

DataType de la nueva columna.

expression: String

Expresión que se va a asignar a la Expression propiedad .

Devoluciones

DataColumn

Objeto recién creado DataColumn.

Excepciones

DuplicateNameException

La colección ya tiene una columna con el nombre especificado. (La comparación no distingue mayúsculas de minúsculas).

InvalidExpressionException

La expresión no es válida. Consulte la Expression propiedad para obtener más información sobre cómo crear expresiones.

Ejemplos

En el ejemplo siguiente se crea y se agrega un nuevo DataColumn a DataColumnCollection un de .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

Comentarios

Si null o se pasa una cadena vacía ("") para el nombre, se asigna un nombre predeterminado ("Column1", "Column2", etc.) a la columna.

Use el Contains método para determinar si ya existe una columna con el nombre propuesto en la colección.

Si la colección cambia correctamente agregando o quitando columnas, se produce el CollectionChanged evento .

Consulte también

Se aplica a

Comentarios

¿Le ha resultado útil esta página?