Compartir a través de

Cómo: Agregar columnas a un DataTable

  • Artículo

Cree las columnas individuales (DataColumn) que constituyen las tablas de datos (DataTable) agregándolas a DataColumnCollection de 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 Agregar columnas a la DataTable.

Después de agregar las columnas, se pueden configurar para que cumplan los 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 de 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 Personalizar la configuración de desarrollo en Visual Studio.

Tareas comunes

Tarea

Contenido adicional

Agregar columnas a tablas: puede agregar columnas mediante el Diseñador de DataSet, el Asistente para configuración de orígenes de datos o el Asistente para configuración de TableAdapter.

Configurar objetos DataColumn: las columnas se agregan con propiedades predeterminadas. Puede personalizar los valores de cada objeto DataColumn para especificar su comportamiento. Por ejemplo, puede especificar el tipo de datos, un valor predeterminado o la restricción de una columna para que contenga valores únicos. Además, puede configurar una columna de datos para mostrar un valor calculado en lugar de un valor que se lee directamente de la base de datos.

Agregar columnas a una tabla de datos

Antes de poder configurar un objeto DataColumn, debe agregarlo primero 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 el 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. Seleccione 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.

Configurar objetos DataColumn

Después de agregar un objeto DataColumn, especifique el comportamiento de ese objeto DataColumn. Por ejemplo, es posible que desee cambiar el tipo de datos o limitarlo para que contenga solamente valores únicos. Puede usar cualquiera de los procedimientos siguientes para modificar el comportamiento del objeto DataColumn.

Establecer el tipo de datos de un objeto DataColumn

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 un objeto 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 el 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.

Especificar que un objeto DataColumn contiene números generados automáticamente

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 el 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

    Parámetro

    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.

Asignar un valor predeterminado a DataColumn

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 un objeto DataColumn para que contenga valores únicos

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. Al marcar una columna como clave principal en el diseñador de DataSet, se creará una restricción UNIQUE.

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

  1. Abra el 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.

Establecer un objeto DataColumn como clave principal en un objeto 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 el 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 un objeto DataColumn 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. Siga uno de estos procedimientos:

    • 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".

Configurar un objeto 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 el 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

Categoría

Tema

Información general: obtenga más información sobre cómo trabajar con datos en Visual Studio.

Procedimientos adicionales: obtenga más información sobre otros procedimientos para trabajar con datos.

Referencia: obtenga más información sobre las clases y miembros que se utilizan para trabajar con datos.