Cómo: Agregar columnas a un DataTable

Crea las columnas individuales (DataColumn) que constituyen las tablas de datos (DataTable) agregándolos a DataColumnCollection para una tabla de datos.Puede agregar las columnas a las tablas de datos en forma visual con el Diseñador de DataSet o con uno de los asistentes de datos.Para obtener más información sobre cómo agregar columnas de datos a tablas de datos mediante programación, vea Adding Columns to a Table.

Después de agregar las columnas, puede configurarlas para cumplir sus requisitos.Por ejemplo, puede especificar un valor predeterminado, o una restricción de unicidad de una columna.También puede especificar que una columna debería mostrar un valor calculado, en lugar de un valor leído directamente en la base de datos.

[!NOTA]

Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, en función de los valores de configuración o de edición activos.Para cambiar la configuración, elija Importar y exportar configuraciones en el menú Herramientas.Para obtener más información, vea Valores de configuración de Visual Studio.

Tareas comunes

Agregar columnas a una tabla de datos

Antes de poder configurar una DataColumn, primero debe agregarlo a un objeto DataTable.Puede hacerlo utilizando cualquiera de los procedimientos siguientes.

Para agregar una columna a un DataTable con el Diseñador de DataSet

1. Abra su conjunto de datos en el Diseñador de DataSet.Para obtener más información, vea Cómo: Abrir un objeto Dataset en el Diseñador de Dataset.

2. Haga clic con el botón secundario del mouse en DataTable para agregar la columna.Señale Agregar y, a continuación, haga clic en Columna.

3. Reemplace el nombre de columna predeterminado, si lo desea, seleccionando el nombre de la columna en la tabla de datos y editando el texto.

4. Establezca la propiedad DataType en la ventana Propiedades.

Para agregar una columna a un DataTable con el Asistente para configuración de orígenes de datos

1. En la ventana Orígenes de datos, haga clic con el botón secundario del mouse en el origen de datos y, a continuación, haga clic en Configurar DataSet con el asistente.

2. Expanda la tabla a la que desea agregar una columna.

3. Seleccione las columnas para agregar a la tabla.

4. Haga clic en Finalizar.

Para agregar una columna a un DataTable con el Asistente para la configuración de TableAdapter

1. Abra su conjunto de datos en el Diseñador de DataSet.Para obtener más información, vea Cómo: Abrir un objeto Dataset en el Diseñador de Dataset.

2. Haga clic con el botón secundario del mouse en la tabla de datos y, a continuación, haga clic en Configurar.

3. Agregue la columna a la instrucción SELECT.

4. Haga clic en Finalizar.

DataColumns de configuración

Después de agregar una columna de datos, se especifica el comportamiento de ese DataColumn.Por ejemplo, puede cambiar el tipo de datos o para limitarlo para contener sólo valores únicos.Puede usar los procedimientos de cualquiera de los siguientes para modificar el comportamiento de DataColumn.

• Setting the Data Type of a DataColumn

• Specifying the Caption of a DataColumn

• Specifying that a DataColumn Contain Auto-Generated Numbers

• Assigning a Default Value to a DataColumn

• Constraining a DataColumn to Contain Unique Values

• Setting a DataColumn to be the Primary Key in a DataTable

• Specifying the Return Value when the Value of a DataColumn is Null

Establecer el tipo de datos de una columna de datos

Las columnas de datos (DataColumn) se crean con un tipo de datos predeterminado de String.Para cambiar el tipo de datos de una columna, establezca la propiedad DataType en la ventana Propiedades.

Para modificar el tipo de datos de una DataColumn

1. Abra un conjunto de datos en el Diseñador de Dataset.

2. Seleccione la columna en la que desea establecer el tipo de datos.

3. En la ventana Propiedades, seleccione el tipo de datos deseado en la lista DataType.

Especificar la leyenda de una DataColumn

Las columnas de datos a menudo tienen nombres no apropiados para mostrar en una interfaz de usuario.Es posible cambiar la leyenda a un nombre más conveniente estableciendo la propiedad Caption en la ventana Propiedades.

[!NOTA]

Se debe tener en cuenta una consideración especial al arrastrar elementos desde la ventana Orígenes de datos hasta un formulario de una aplicación Windows: a los nombres de columna de las etiquetas de leyenda se les vuelve a aplicar formato en una cadena que se lee más fácilmente cuando dos o más palabras están concatenadas.Para obtener más información, vea Cómo: Personalizar el modo en que Visual Studio crea los títulos de controles enlazados a datos.

Para editar la leyenda de una columna de datos

1. Abra su conjunto de datos en el Diseñador de DataSet.Para obtener más información, vea Cómo: Abrir un objeto Dataset en el Diseñador de Dataset.

2. Seleccione la columna cuya leyenda desea editar.

3. En la ventana Propiedades, establezca la propiedad Caption.

El especificar números Auto- Generados de DataColumn un Contienen

Las columnas de datos (DataColumn) contienen a menudo números secuenciales generados automáticamente; por ejemplo, claves principales y columnas de identidad.Puede cargar los números generados automáticamente en columnas de datos estableciendo las propiedades AutoIncrement, AutoIncrementSeed y AutoIncrementStep de la columna de datos.

Cuando las columnas de datos se crean por medio de las herramientas de diseño de Visual Studio, las columnas se marcan automáticamente como AutoIncrement.Al actualizar una tabla de la base de datos que contiene una columna de identidad, no se envían a la base de datos los valores creados con la característica de numeración automática.

Para establecer una columna de datos para contener números generados automáticamente

1. Abra su conjunto de datos en el Diseñador de DataSet.

2. Seleccione la columna que desea rellenar con números generados automáticamente.

3. En la ventana Propiedades, defina las propiedades siguientes:

   Propiedad.	Configuración
   AutoIncrement	true
   AutoIncrementSeed	Si desea comenzar en un número diferente del valor predeterminado de 0, establezca este valor en el número de inicio para esta columna.
   AutoIncrementStep	Este valor incrementa el valor de columna en cada nueva fila.

   [!NOTA]

   El establecimiento de una columna de datos para incrementarse automáticamente no designa la columna como clave principal de forma automática.

Asignación de un valor predeterminado a una columna de datos

A las columnas de datos se les pueden asignar valores predeterminados.El valor predeterminado se asigna a la columna cuando se crean nuevas filas (registros).

Para asignar un valor predeterminado a una columna de datos

1. Abra un conjunto de datos en el Diseñador de Dataset.

2. Seleccione la columna a la que desea asignar un valor predeterminado.

3. En la ventana Propiedades, establezca la propiedad DefaultValue en el estilo que desee.

Restringir una DataColumn a valores únicos de Contienen

Se establece una DataColumn para contener los valores únicos agregando una restricción UNIQUE a una tabla de datos.Las restricciones UNIQUE también se denominan claves.Marcar una columna como clave principal en el diseñador de dataset creará una restricción UNIQUE

Para restringir una columna con el fin de que contenga valores únicos

1. Abra su conjunto de datos en el Diseñador de DataSet.

2. Haga clic con el botón secundario del mouse en la columna que desea restringir a valores únicos.Seleccione Agregary, a continuación, haga clic en Clave.

3. Compruebe que la columna correcta esté seleccionada en el cuadro de diálogo Restricción UNIQUE.

4. Reemplace el nombre predeterminado de la restricción con un nombre más descriptivo, si lo desea.

Estableciendo una DataColumn para ser la clave principal en una DataTable

Establecer una columna de datos como clave principal garantiza que cada registro contenga un valor único.Sólo una clave principal puede asignarse a una tabla de datos.Es posible crear una clave principal en una tabla de datos mediante el Diseñador de DataSet.

Para establecer una columna de datos como clave principal en una tabla de datos

1. Abra su conjunto de datos en el Diseñador de DataSet.

2. Haga clic con el botón secundario en la columna que desea establecer como clave principal.Haga clic en Establecer clave principal.

   Un icono clave aparece al lado de las columnas seleccionadas.

Especificar el valor devuelto cuando el valor de una columna de datos es Null

En un conjunto de datos con tipo, puede controlar la representación de columnas que contienen valores null.Este comportamiento está disponible únicamente cuando se recuperan valores de columna a través de sus descriptores de acceso con tipo.Si recupera el valor por medio del índice de fila o de columna de la tabla, no podrá definir el valor devuelto.El motivo es que la lógica para devolver este valor se integra en el establecedor de la propiedad de la columna de datos específica en la clase de conjunto de datos generada.

Para establecer el valor devuelto cuando el valor de una columna de datos es nulo

1. Abra el conjunto de datos en el Diseñador de Dataset.

2. Seleccione una columna en una tabla de datos.

3. En la ventana Propiedades, seleccione la propiedad NullValue.

4. Realice una de estas acciones:

   • En la lista desplegable, seleccione el valor correspondiente:

     Valor	Descripción
     (Vacío)	Devuelve valores NULL de String.Empty.
     (Nada)	Devuelve valores NULL como DBNull.
     (Producir una excepción)	Los valores NULL producen una Exception.

     O bien

   • Establezca la propiedad en cualquier valor personalizado válido para el tipo de datos de esa columna.Por ejemplo, si especifica la cadena Sin valor en una columna con un tipo de datos String, en todos los registros que contengan valores null en esa columna aparecerá "Sin valor".

Configure una DataColumn para mostrar una expresión

Una tabla de datos en un conjunto de datos puede contener columnas en las que el valor se calcula en lugar de leerse desde la base de datos.Por ejemplo, en un registro de detalles de pedidos, podría ser útil definir una columna ExtendedPrice en la que se multiplique la cantidad por el precio, en lugar de almacenar el total en el registro.Las columnas calculadas también pueden agregar o contar valores de registros secundarios y filtrar otros registros.Se pueden definir columnas calculadas por medio de expresiones.

La sintaxis de la expresión consta de operadores estándar.Puede hacer referencia a un valor de datos por medio de su nombre de columna (como haría en una instrucción SQL) e incluir funciones agregadas como Count.

Por ejemplo, la expresión para una columna ExtendedPrice basada en las columnas UnitPrice por Quantity del registro actual, podría ser sencillamente:

UnitPrice * Quantity

Para hacer referencia a columnas de tablas secundarias, puede utilizar la palabra reservada Child, seguida del nombre de la columna.Por ejemplo, la expresión siguiente devuelve el valor promedio de la columna Price en todos los registros secundarios relacionados:

Avg(Child.Price)

Para obtener más información, vea la propiedad Expression.

Puede crear columnas de expresión en el Diseñador de DataSet.Para obtener más información acerca la creación de columnas, veaCómo: Agregar columnas a un DataTable.

Para crear expresiones de columnas en el Diseñador de DataSet

1. Abra su conjunto de datos en el Diseñador de DataSet.Para obtener más información, vea Cómo: Abrir un objeto Dataset en el Diseñador de Dataset.

2. En la tabla de datos que desee, seleccione la columna a la que desea agregar la expresión o agregue una nueva columna a la tabla.Para obtener más información, vea Cómo: Agregar columnas a un DataTable.

3. En la ventana Propiedades, escriba una expresión en la propiedad Expression.

Temas relacionados