DataColumnCollection.Add Método

  • Referencia

Definición

Espacio de nombres:
System.Data
Ensamblado:
System.Data.Common.dll
Ensamblado:
System.Data.dll
Ensamblado:
netstandard.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
Source:
DataColumnCollection.cs
Source:
DataColumnCollection.cs

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

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

Se aplica a

Add(DataColumn)

Source:
DataColumnCollection.cs
Source:
DataColumnCollection.cs
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

Se aplica a

Add(String)

Source:
DataColumnCollection.cs
Source:
DataColumnCollection.cs
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:
 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

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

Se aplica a

Add(String, Type)

Source:
DataColumnCollection.cs
Source:
DataColumnCollection.cs
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:
 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

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

Se aplica a

Add(String, Type, String)

Source:
DataColumnCollection.cs
Source:
DataColumnCollection.cs
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:
 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

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

Se aplica a