DataColumnCollection.Add Método

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Crea y agrega un objeto DataColumn a la colección DataColumnCollection.

Sobrecargas

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

Add()

Source:

DataColumnCollection.cs

Crea y agrega un objeto DataColumn a la colección DataColumnCollection.

public:
 System::Data::DataColumn ^ Add();

public System.Data.DataColumn Add ();

member this.Add : unit -> System.Data.DataColumn

Public Function Add () As DataColumn

Devoluciones

DataColumn

Colección DataColumn creada recientemente.

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

• ColumnName
• Contains(String)
• DataType
• Expression

Add(DataColumn)

Source:

DataColumnCollection.cs

Crea y agrega el objeto DataColumn especificado a la colección 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

DataColumn que se va a agregar.

Excepciones

ArgumentNullException

El parámetro column es null.

ArgumentException

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

DuplicateNameException

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

InvalidExpressionException

La expresión no es válida. Vea la propiedad Expression 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

• ColumnName
• CollectionChanged
• Contains(String)
• DataType
• Expression

Add(String)

Source:

DataColumnCollection.cs

Crea un objeto DataColumn que tiene el nombre especificado y lo agrega a la colección DataColumnCollection.

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName);

public System.Data.DataColumn Add (string? columnName);

member this.Add : string -> System.Data.DataColumn

Public Function Add (columnName As String) As DataColumn

Parámetros

columnName

String

El nombre de la columna.

Devoluciones

DataColumn

Colección DataColumn creada recientemente.

Excepciones

DuplicateNameException

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

Ejemplos

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

• ColumnName
• Contains(String)
• DataType
• Expression

Add(String, Type)

Source:

DataColumnCollection.cs

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

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);

public System.Data.DataColumn Add (string? columnName, Type type);

member this.Add : string * Type -> System.Data.DataColumn

Public Function Add (columnName As String, type As Type) As DataColumn

Parámetros

columnName

String

Propiedad ColumnName que se va a utilizar al crear la columna.

type

Type

DataType de la nueva columna.

Devoluciones

DataColumn

Colección DataColumn creada recientemente.

Excepciones

DuplicateNameException

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

InvalidExpressionException

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

Ejemplos

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

• ColumnName
• DataType
• Expression

Add(String, Type, String)

Source:

DataColumnCollection.cs

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

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);

public System.Data.DataColumn Add (string? columnName, Type type, string expression);

member this.Add : string * Type * string -> System.Data.DataColumn

Public Function Add (columnName As String, type As Type, expression As String) As DataColumn

Parámetros

columnName

String

Nombre que se va a utilizar al crear la columna.

type

Type

DataType de la nueva columna.

expression

String

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

Devoluciones

DataColumn

Colección DataColumn creada recientemente.

Excepciones

DuplicateNameException

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

InvalidExpressionException

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

Ejemplos

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

• ColumnName
• Contains(String)
• DataType
• Expression