DataColumn Constructores

Definición

Espacio de nombres:

System.Data

Ensamblados:

netstandard.dll, System.Data.Common.dll

Inicializa una nueva instancia de la clase DataColumn.

Sobrecargas

Nombre	Description
DataColumn()	Inicializa una nueva instancia de la DataColumn clase como cadena de tipo.
DataColumn(String)	Inicializa una nueva instancia de la DataColumn clase , como cadena de tipo, con el nombre de columna especificado.
DataColumn(String, Type)	Inicializa una nueva instancia de la DataColumn clase utilizando el nombre de columna y el tipo de datos especificados.
DataColumn(String, Type, String)	Inicializa una nueva instancia de la DataColumn clase utilizando el nombre, el tipo de datos y la expresión especificados.
DataColumn(String, Type, String, MappingType)	Inicializa una nueva instancia de la DataColumn clase utilizando el nombre, el tipo de datos, la expresión y el valor especificados que determina si la columna es un atributo.

DataColumn()

Source:

DataColumn.cs

Inicializa una nueva instancia de la DataColumn clase como cadena de tipo.

public:
 DataColumn();

public DataColumn();

Public Sub New ()

Ejemplos

En el ejemplo siguiente se crea un nuevo DataColumn, se establecen varias propiedades y se agrega a para DataColumnCollection el DataTable objeto .

private void AddDataColumn(DataTable table)
{
    DataColumn column = new DataColumn();

    // Set various properties.
    column.ColumnName = "id";
    column.DataType = System.Type.GetType("System.Int32");
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As New DataColumn()

    ' Set various properties.
    With column
       .ColumnName = "id"
       .DataType = System.Type.GetType("System.Int32")
       .AutoIncrement = True
       .AutoIncrementSeed = 1
       .AutoIncrementStep = 1
       .ReadOnly = True
     End With

    ' Add to Columns collection.
    table.Columns.Add(column)
End Sub

Comentarios

Cuando se crea, un DataColumn objeto no tiene ningún valor predeterminado ColumnName o Caption. Cuando se agrega a , DataColumnCollectionse generará un nombre predeterminado ("Column1", "Column2", etc.) si no se ha asignado un nombre a ColumnName.

Consulte también

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• Uso de conjuntos de datos en ADO.NET

DataColumn(String)

Source:

DataColumn.cs

Inicializa una nueva instancia de la DataColumn clase , como cadena de tipo, con el nombre de columna especificado.

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

public DataColumn(string? columnName);

new System.Data.DataColumn : string -> System.Data.DataColumn

Public Sub New (columnName As String)

Parámetros

columnName

String

Cadena que representa el nombre de la columna que se va a crear. Si se establece en null o en una cadena vacía (""), se especificará un nombre predeterminado cuando se agregue a la colección de columnas.

Ejemplos

En el ejemplo siguiente se crea un nuevo DataColumn con un especificado ColumnName.

private void AddDataColumn(DataTable table)
{
    DataColumn column = new DataColumn("id");

    // Set various properties.
    column.DataType = System.Type.GetType("System.Int32");
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As DataColumn 
    column = New DataColumn("id")

    ' Set various properties.
    With column
       .DataType = System.Type.GetType("System.Int32")
       .AutoIncrement = True
       .AutoIncrementSeed = 1
       .AutoIncrementStep = 1
       .ReadOnly = True
     End With

    ' Add to Columns collection.
    table.Columns.Add(column)
End Sub

Comentarios

De forma predeterminada, el nombre específico de una columna se convierte en el valor de propiedad Caption .

Consulte también

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• Uso de conjuntos de datos en ADO.NET

DataColumn(String, Type)

Source:

DataColumn.cs

Inicializa una nueva instancia de la DataColumn clase utilizando el nombre de columna y el tipo de datos especificados.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType);

public DataColumn(string? columnName, Type dataType);

new System.Data.DataColumn : string * Type -> System.Data.DataColumn

Public Sub New (columnName As String, dataType As Type)

Parámetros

columnName

String

Cadena que representa el nombre de la columna que se va a crear. Si se establece en null o en una cadena vacía (""), se especificará un nombre predeterminado cuando se agregue a la colección de columnas.

dataType

Type

Compatible con DataType.

Excepciones

ArgumentNullException

No dataType se especificó.

Ejemplos

En el ejemplo siguiente se crea un nuevo DataColumn con un especificado ColumnName y DataType.

private void AddDataColumn(DataTable table)
{
    System.Type typeInt32 =
        System.Type.GetType("System.Int32");
    DataColumn column = new DataColumn("id", typeInt32);

    // Set various properties.
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    
   Dim typeInt32 As System.Type = _
      System.Type.GetType("System.Int32")
   Dim column As DataColumn = _
       New DataColumn("id", typeInt32)

   ' Set various properties.
   With column
      .AutoIncrement = True
      .AutoIncrementSeed = 1
      .AutoIncrementStep = 1
      .ReadOnly = True
    End With

   ' Add to Columns collection.
   table.Columns.Add(column)
End Sub

Consulte también

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Uso de conjuntos de datos en ADO.NET

DataColumn(String, Type, String)

Source:

DataColumn.cs

Inicializa una nueva instancia de la DataColumn clase utilizando el nombre, el tipo de datos y la expresión especificados.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")]
public DataColumn(string? columnName, Type dataType, string? expr);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")>]
new System.Data.DataColumn : string * Type * string -> System.Data.DataColumn

Public Sub New (columnName As String, dataType As Type, expr As String)

Parámetros

columnName

String

Cadena que representa el nombre de la columna que se va a crear. Si se establece en null o en una cadena vacía (""), se especificará un nombre predeterminado cuando se agregue a la colección de columnas.

dataType

Type

Compatible con DataType.

expr

String

Expresión que se usa para crear esta columna. Para obtener más información, consulte la propiedad Expression.

Atributos

RequiresUnreferencedCodeAttribute

Excepciones

ArgumentNullException

No dataType se especificó.

Ejemplos

En el ejemplo siguiente se crea una columna calculada.

private void AddDataColumn(DataTable table)
{
    System.Type decimalType;
    decimalType = System.Type.GetType("System.Decimal");

    // Create the column. The name is 'Tax,' with data type Decimal,and
    // an expression ('UnitPrice * .0862) to calculate the tax.
    DataColumn column = new DataColumn("Tax",
        decimalType, "UnitPrice * .0862");

    // Set various properties.
    column.AutoIncrement = false;
    column.ReadOnly = true;

    // Add to Columns collection.;
    table.Columns.Add(column);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As DataColumn 
    Dim decimalType As System.Type
 
    decimalType = System.Type.GetType("System.Decimal")
    column = New DataColumn("Tax", decimalType, "UnitPrice * .0862")

    ' Set various properties.
    With column
       .AutoIncrement = False
       .ReadOnly = True
    End With

    ' Add to Columns collection.
    table.Columns.Add(column)
 End Sub

Consulte también

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Expression
• Uso de conjuntos de datos en ADO.NET

DataColumn(String, Type, String, MappingType)

Source:

DataColumn.cs

Inicializa una nueva instancia de la DataColumn clase utilizando el nombre, el tipo de datos, la expresión y el valor especificados que determina si la columna es un atributo.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr, System::Data::MappingType type);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")]
public DataColumn(string? columnName, Type dataType, string? expr, System.Data.MappingType type);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")>]
new System.Data.DataColumn : string * Type * string * System.Data.MappingType -> System.Data.DataColumn

Public Sub New (columnName As String, dataType As Type, expr As String, type As MappingType)

Parámetros

columnName

String

Cadena que representa el nombre de la columna que se va a crear. Si se establece en null o en una cadena vacía (""), se especificará un nombre predeterminado cuando se agregue a la colección de columnas.

dataType

Type

Compatible con DataType.

expr

String

Expresión que se usa para crear esta columna. Para obtener más información, consulte la propiedad Expression.

type

MappingType

Uno de los MappingType valores.

Atributos

RequiresUnreferencedCodeAttribute

Excepciones

ArgumentNullException

No dataType se especificó.

Ejemplos

En el ejemplo siguiente se construye una columna calculada.

private void CreateComputedColumn(DataTable table)
{
    System.Type myDataType =
        System.Type.GetType("System.Decimal");

    // The expression multiplies the "Price" column value
    // by the "Quantity" to create the "Total" column.
    string expression = "Price * Quantity";

    // Create the column, setting the type to Attribute.
    DataColumn column = new DataColumn("Total", myDataType,
        expression, MappingType.Attribute);

    // Set various properties.
    column.AutoIncrement = false;
    column.ReadOnly = true;

    // Add the column to a DataTable object's to DataColumnCollection.
    DataSet1.Tables["OrderDetails"].Columns.Add(column);
}

Private Sub CreateComputedColumn(ByVal table As DataTable)
    Dim column As DataColumn
    Dim decimalType As System.Type = _
        System.Type.GetType("System.Decimal")

    ' The expression multiplies the "Price" column value by the 
    ' "Quantity" to create the "Total" column.
    Dim expression As String = "Price * Quantity"

    ' Create the column, setting the type to Attribute.
    column = New DataColumn("Total", decimalType, _
        expression, MappingType.Attribute)

    ' Set various properties.
    column.AutoIncrement = False
    column.ReadOnly = True

    ' Add the column to a DataTable object's DataColumnCollection.
    DataSet1.Tables("OrderDetails").Columns.Add(column)
End Sub

Comentarios

El type argumento establece la ColumnMapping propiedad . La propiedad especifica cómo se asigna un DataColumn objeto cuando DataSet se transforma en un documento XML. Por ejemplo, si la columna se denomina "fName", y el valor que contiene es "Bob", y type se establece en MappingType.Attribute, el elemento XML sería el siguiente:

<Nombre fName = 'Bob'/>

Para obtener más información sobre cómo se asignan las columnas a elementos o atributos, vea la ColumnMapping propiedad .

Consulte también

• ColumnName
• ColumnMapping
• Caption
• DefaultValue
• DataTable
• DataType
• Uso de conjuntos de datos en ADO.NET