DataColumn (Clase)

El DataColumn es el bloque constructivo fundamental para crear el esquema de un DataTable. Para construir el esquema, se agregan uno o varios objetos DataColumn al DataColumnCollection. Para obtener más información, vea Agregar columnas a la DataTable (ADO.NET).

Cada DataColumn tiene una propiedad DataType que determina el tipo de datos que contiene el DataColumn. Por ejemplo, se puede restringir el tipo de datos a enteros, cadenas o decimales. Puesto que los datos incluidos en el objeto DataTable normalmente se vuelven a combinar en su origen de datos original, se debe hacer coincidir los tipos de los datos con los del origen de datos. Para obtener más información, vea Asignar tipos de datos en ADO.NET.

Propiedades como AllowDBNull, Unique y ReadOnly aplican restricciones en la entrada y actualización de datos, lo que contribuye a garantizar la integridad de éstos. También se pueden utilizar las propiedades AutoIncrement, AutoIncrementSeed y AutoIncrementStep para controlar la generación automática de datos. Para obtener más información sobre las columnas AutoIncrement, vea Crear columnas AutoIncrement (ADO.NET). Para obtener más información, vea Definir claves principales (ADO.NET).

También se puede garantizar que los valores de un objeto DataColumn son únicos mediante la creación de una restricción UniqueConstraint y su adición a la colección ConstraintCollection del objeto DataTable al que pertenece el objeto DataColumn. Para obtener más información, vea Restricciones de DataTable (ADO.NET).

Para crear una relación entre objetos DataColumn, cree un objeto DataRelation y agréguelo al DataRelationCollection de un DataSet.

También se puede utilizar la propiedad Expression del objeto DataColumn para calcular los valores de una columna o para crear una columna agregada. Para obtener más información, vea Crear columnas de expresión (ADO.NET).

En el ejemplo siguiente se crea un DataTable con varios objetos DataColumn.

private void MakeTable()
{ 
    // Create a DataTable. 
    DataTable table = new DataTable("Product");

    // Create a DataColumn and set various properties. 
    DataColumn column = new DataColumn(); 
    column.DataType = System.Type.GetType("System.Decimal"); 
    column.AllowDBNull = false; 
    column.Caption = "Price"; 
    column.ColumnName = "Price"; 
    column.DefaultValue = 25; 

    // Add the column to the table. 
    table.Columns.Add(column); 

    // Add 10 rows and set values. 
    DataRow row; 
    for(int i = 0; i < 10; i++)
    { 
        row = table.NewRow(); 
        row["Price"] = i + 1; 

        // Be sure to add the new row to the 
        // DataRowCollection. 
        table.Rows.Add(row); 
    } 
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Este tipo es seguro para operaciones de lectura multiproceso. Debe sincronizar cualquier operación de escritura.

Referencia

Otros recursos