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 una tabla.

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 los tipos de datos del proveedor de datos para los tipos de datos de .NET Framework.

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. Para obtener más información, vea Definir una clave principal para una tabla.

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 Agregar restricciones a una tabla.

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.

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); 
    } 
}

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

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

.NET Compact Framework