Columnas, Propiedades de DataGrid (Cuadro de diálogo)

  • Artículo

 

Publicado: abril de 2016

La ficha Columnas del cuadro de diálogo Propiedades de DataGrid permite:

  • Especificar qué columnas de datos aparecen en la cuadrícula.

  • Definir columnas para funciones especiales tales como editar y seleccionar elementos.

  • Definir columnas de plantilla.

  • Especificar información concreta para columnas individuales, tales como una expresión de orden y un nombre de comando.

  • Definir el encabezado y el pie, el contenido y el enlace de datos para cada columna de la cuadrícula.

Después de definir una columna, puede establecer sus propiedades.  Las opciones disponibles en la ficha Columnas cambian de acuerdo con el tipo de columna de DataGrid con el que se trabaja.  

Nota

ASP.NET versión 2.0 se suministra con un nuevo control de servidor, GridView, que tiene más características que el control DataGrid.  Para obtener más información, vea Comparing the GridView and DataGrid Web Server Controls.  

  1. En Microsoft Visual Web Developer, abra o cree una página .aspx.

  2. En la vista Código fuente, agregue un control DataGrid a la página en el elemento <form>.  El código podría tener el aspecto siguiente:  

    <form id="form1" runat="server">
    <div>
    <asp:DataGrid ID="DataGrid1" runat="server"></asp:DataGrid>
    </div>
</form>

  3. Cambie a la vista Diseño.

  4. Haga clic con el botón secundario del mouse en el control DataGrid y haga clic en Mostrar etiqueta inteligente.

    Se abre la ventana Tareas de DataGrid.

  5. Haga clic en Generador de propiedades.

    Se abre el cuadro de diálogo Propiedades de DataGrid.

  6. Haga clic en la ficha Columnas.

Tareas

Elementos de interfaz de usuario

  • Crear columnas automáticamente en tiempo de ejecución
    Especifica si la cuadrícula, en tiempo de ejecución, incluye todos los campos de datos del origen de datos a la que está enlazada.  No es posible quitar estas columnas ni cambiar su formato.  

    Puede agregar columnas, incluidas columnas enlazadas a datos así como las columnas de botón, hipervínculo y plantilla, tal como se describe a continuación en la sección "Lista de columnas".  Cualquier columna que agregue aparecerá a la izquierda de las columnas generadas automáticamente.  

Lista de columnas

La lista de columnas permite especificar qué columnas aparecen en la cuadrícula.  Puede agregar campos desde el origen de datos, así como varios tipos de botones.  

Para agregar una columna, seleccione su tipo en Columnas disponibles y, a continuación, haga clic en el botón Agregar para agregarla a la lista Columnas seleccionadas.  Para especificar la ubicación de la columna en la cuadrícula, selecciónela en la lista Columnas seleccionadas y, a continuación, utilice los botones para volver a ordenar para moverla.  Para quitar una columna de la cuadrícula, selecciónela en la lista Columnas seleccionadas y, a continuación, haga clic en el botón Eliminar.  

  • Columnas disponibles
    Muestra una lista de todas las columnas que puede mostrar la cuadrícula, dividida en los nodos siguientes:

    • Columna enlazada   Utilice este nodo para agregar columnas de datos individuales de las disponibles en el origen de datos seleccionado en la ficha General.

      Si está seleccionada la opción Crear columnas automáticamente en tiempo de ejecución, se mostrarán todas las columnas del nodo.  Para mostrar sólo algunas columnas, desactive Crear columnas automáticamente en tiempo de ejecución y agregue los campos de datos que desee utilizar.  

    • **Columna botón   **Utilícelo para agregar columnas que contengan botones (de comando o de vínculo) en los que el usuario pueda hacer clic para ejecutar acciones específicas para un elemento individual.  Expanda el nodo Columna botón para agregar a la cuadrícula botones Seleccionar, Eliminar o Editar.  Para agregar un botón personalizado (como por ejemplo un botón con el texto "Agregar a la compra "), seleccione el nodo Columna botón, haga clic en el botón Agregar y, a continuación, dé formato al botón personalizado.  

    • **Columna Hipervínculo   **Utilícelo para agregar una columna que contendrá un vínculo con otra página.  La columna hipervínculo puede contener texto estático o mostrar una columna de datos como hipervínculo.  

    • **Columna Plantilla   **Utilícelo para crear una columna que contenga cualquier combinación de texto y controles HTML.  Las columnas plantilla permiten incluir controles diferentes de los botones (por ejemplo, casillas) en un control DataGrid.  

  • Columnas seleccionadas
    Muestra una lista de las columnas que puede personalizar.  Cuando seleccione una columna de esta lista, las opciones que aparecen debajo de ella en el cuadro de diálogo cambiarán para reflejar las configuraciones que se pueden personalizar para la columna.  

    Si está seleccionada la opción Crear columnas automáticamente en tiempo de ejecución, Columnas seleccionadas muestra una lista de las columnas que aparecerán además de las columnas generadas automáticamente.

Propiedades de columna

  • Texto del encabezado
    Texto que se muestra en la parte superior de la columna.  El valor del encabezado puede establecerse en cualquier texto HTML (incluidas las etiquetas).  Puede especificar la fuente y el color del encabezado en la ficha Formato.  

    El texto que se especifica para el encabezado se convierte en el identificador para la columna en la lista Columnas seleccionadas.

    Los encabezados sólo se muestran si está activada la casilla Mostrar encabezado en la ficha General.

  • Texto de pie
    Texto que se muestra en la parte inferior de la columna.  De forma predeterminada, está en blanco.  El valor del pie puede establecerse en cualquier texto HTML (incluidas las etiquetas).  Se puede especificar la fuente y el color del encabezado en la ficha Formato.  

    Los pies sólo se muestran si está activada la casilla Mostrar pie en la ficha General.

  • Imagen del encabezado
    Dirección URL de un archivo de imagen que se muestra en la parte superior de la columna.  Si especifica tanto un texto como una imagen de encabezado, la imagen tendrá precedencia.  

  • Expresión de ordenación
    Cadena que se pasa como parámetro cuando se produce el evento SortCommand.  Normalmente, se activa la casilla Permitir ordenación en la ficha General, por lo que los encabezados de columna se representan como controles LinkButton que provocan el evento SortCommand cuando se hace clic en ellos.  

    Para las columnas enlazadas, la expresión de ordenación predeterminada es el nombre del campo de datos al que está enlazada la columna.  No obstante, es posible especificar cualquier cadena.  

  • Visible
    Indica si la columna está visible de forma predeterminada cuando se ejecuta la página.  Si se desactiva esta casilla, se podrá definir una columna y especificar la información de enlace y formato; a continuación, se podrá mostrar y ocultar la columna dinámicamente en tiempo de ejecución.  

Propiedades BoundColumn

Las opciones en Propiedades BoundColumn se muestran si se selecciona Columna enlazada en Columnas disponibles y se hace clic en el botón de flecha para moverla hasta Columnas seleccionadas.

  • Campo de datos
    Nombre del campo de datos al que está enlazada esta columna.  Sólo lectura.  

  • Expresión de formato de datos
    Expresión de formato de .NET Framework que se aplica a los datos antes de que se muestren en la columna.  Esta expresión está formada por texto estático y un especificador de formato como se muestra a continuación:  

    {0:format specifier}

    El número delante de los dos puntos (:) es un índice de parámetro que indica los elementos de datos de la columna a los que se va a dar formato; por tanto, el valor suele ser cero para indicar el primer (y único) elemento.  Elformat specifierva a continuación de los dos puntos y está formado por una o varias letras que indican cómo dar formato a los datos.  Los caracteres del especificador de formato que se pueden utilizar están en función del tipo de datos a los que se va a dar formato como fechas, números u otro tipo de datos.  En la siguiente tabla se muestran ejemplos de expresiones de formato para distintos tipos de datos.  Para obtener más información sobre expresiones de formato, vea Tipos de formatos.  

    Expresión de formato

    Tipo de datos a los que se aplica

    Descripción

    Precio: {0:C}

    numérico/decimal

    Muestra la cadena literal "Precio:" seguido de números en formato de moneda.  El formato de moneda depende de la configuración de la referencia cultural especificada mediante el atributo culture en la directiva @ Page o en el archivo Web.config.  

    {0:D4}

    entero (no se puede utilizar con números decimales)

    Los números enteros se muestran en un campo rellenado con ceros, de cuatro caracteres de ancho.

    {0:N2}%

    numeric

    Muestra el número con una precisión de 2 posiciones decimales, seguido de la cadena literal "%".

    {0:000.0}

    numérico/decimal

    Números redondeados a una posición decimal.  Los números de menos de tres dígitos se rellenan con ceros.  

    {0:D}

    fecha/fecha y hora

    Formato de fecha largo ("Martes, 06 de agosto de 1996").  El formato de fecha depende de la configuración de la referencia cultural de la página o del archivo Web.config.  

    {0:d}

    fecha/fecha y hora

    Formato de fecha corto ("12/31/99").

    {0:yy-MM-dd}

    fecha/fecha y hora

    Fecha en formato numérico en el orden año-mes-día (96-08-06).

  • De solo lectura
    Indica si los datos de esta columna se mostrarán en un control modificable cuando se ponga el elemento en modo de edición.

Propiedades ButtonColumn

Las opciones en Propiedades ButtonColumn se muestran si se selecciona Columna botón en Columnas disponibles y se hace clic en el botón de flecha para moverla hasta Columnas seleccionadas.

  • Text
    Texto (título) de los botones, si tienen el mismo texto para todos los elementos de la cuadrícula.  Por ejemplo, establezca la propiedad Texto si va a definir un botón que muestre la palabra "Seleccionar" para cada elemento de la cuadrícula.  La propiedad Text field, si está establecida, reemplaza esta propiedad.  

  • Nombre de comando
    Cadena que se pasa con el evento ItemCommand cuando los usuarios hacen clic en el botón.

  • Campo de texto
    Campo del origen de datos que se utilizará como origen del título del botón.  Si establece tanto esta propiedad como la propiedad Text, la propiedad Text field tiene prioridad.  

  • Tipo de botón
    Tipo de botón que se va a representar: LinkButton o PushButton.  La opción predeterminada es un control LinkButton.  

  • Cadena de formato de texto
    Expresión de formato de .NET Framework que se aplica al título del botón antes de que se muestre.  Es útil si se está utilizando la propiedad Text field para establecer el título del botón pero los datos no tienen un formato adecuado para la presentación.  Para obtener información detallada, vea la sección "Propiedades BoundColumn" que aparece anteriormente.  

Propiedades EditCommandColumn

Las opciones en Propiedades EditButtonColumn se muestran si la opción seleccionada en Columnas seleccionadas es una columna de botones Editar.

  • Editar texto
    Cadena que se muestra en el botón Editar.

  • Cancelar texto
    Cadena que se muestra en el botón Cancelar.

  • Actualizar texto
    Cadena que se muestra en el botón Actualizar.

  • Tipo de botón
    Tipo de botón que se va a representar: LinkButton o PushButton.  La opción predeterminada es un control LinkButton.  

Propiedades HyperLinkColumn

Las opciones en Propiedades HyperLinkColumn se muestran si se selecciona Columna hipervínculo en Columnas disponibles y se hace clic en el botón de flecha para moverla hasta Columnas seleccionadas.

  • Text
    Texto del hipervínculo, si los vínculos tienen el mismo texto para todos los elementos de la cuadrícula.

  • URL
    Dirección URL de la página de destino.  Si el Campo de dirección URL está establecido, reemplaza esta propiedad.  

  • Campo de texto
    Campo del origen de datos que se utilizará como origen del texto del hipervínculo.

  • Campo de dirección URL
    Campo o propiedad del objeto de DataSource que proporcionará la dirección URL de la página de destino.  Esta propiedad reemplaza la configuración de Dirección URL.  

  • Cadena de formato de texto
    Especificador de formato de .NET Framework que se aplica al hipervínculo antes de que se muestre.  Es útil si se está utilizando la propiedad Text field para establecer el texto del hipervínculo, pero los datos no tienen un formato adecuado para mostrarse.  Para obtener información detallada, vea la sección "Propiedades BoundColumn" que aparece anteriormente.  

  • Cadena de formato de dirección URL
    Expresión que especifica el formato que recibirá la dirección URL.  La expresión puede incluir una expresión de formato de .NET Framework.  Por ejemplo, podría utilizar un formato de dirección URL como el siguiente:  

    images/Title-{0}.gif

    Este formato podría producir una dirección URL tal como la siguiente:

    images/Title-1.gif

    Para obtener información detallada, vea la sección "Propiedades BoundColumn" que aparece anteriormente.

  • Destino
    Ventana en la que esta columna de botones deberá mostrarse.  Especifique el nombre de una ventana que esté presente en tiempo de ejecución o seleccione uno de la lista predefinida de identificadores estándar de ventanas.  

  • Convertir esta columna en una columna de plantilla
    Recrea la columna seleccionada que se va a usar como plantilla, que es una combinación de texto HTML y controles.  Permite especificar con precisión la apariencia de la columna.  

Ver también

Comparing the GridView and DataGrid Web Server Controls