Compartir a través de


Información general sobre Calendar (Control de servidor Web)

Actualización: noviembre 2007

Puede utilizar el control Calendar de servidor Web para hacer lo siguiente:

  • Mostrar y seleccionar fechas   El control muestra un calendario a través del cual los usuarios pueden desplazarse a cualquier día de cualquier año. Al definir la propiedad SelectedDate, la fecha especificada se resalta en el control. Opcionalmente, los usuarios pueden hacer clic en un día o moverse de mes en mes para ir a fechas arbitrarias. Se puede configurar el calendario para permitir que los usuarios seleccionen varias fechas, ya sea una semana o un mes entero.

    Una representación del control Calendar que muestra el mes de octubre

  • Mostrar información de citas o de otros asuntos en una cuadrícula de calendario   El control Calendar puede mostrar detalles específicos para cada día como, por ejemplo, una lista de tareas pendientes, un programa de acontecimientos u otra información de este tipo. Esta función permite mostrar información del día procedente de una base de datos.

El control Calendar se basa en el objeto DateTime de .NET Framework y, por lo tanto, admite el intervalo completo de fechas que permite este objeto. Puede disponer, de hecho, de cualquier fecha comprendida entre los años 0 y 9999 d.C.

Cuando la página de formularios Web Forms se ejecuta, el control Calendar se representa como una tabla HTML. En consecuencia, ciertas propiedades del control corresponden a varios aspectos del formato de la tabla. Algunas de estas propiedades no son completamente compatibles con algunos de los exploradores más antiguos, por lo que algunas de las características de formato no estarán disponibles en estos exploradores.

Mostrar y seleccionar fechas

El control Calendar muestra las fechas de un mes, con un total de seis semanas. El control admite varios tipos de fechas, que se describen en la tabla siguiente.

Tipo de fecha

Descripción

TodaysDate

De forma predeterminada, se establece para coincidir con la fecha actual del servidor. No obstante, es posible ajustarla para que la fecha aparezca correctamente para una configuración regional diferente.

VisibleDate

Esta fecha determina qué mes aparece en el calendario. El usuario puede moverse de mes en mes por el calendario y cambiar así la fecha visible sin afectar a la fecha actual. Puede establecer la fecha visible mediante programación para desplazarse de mes en mes.

SelectedDate, SelectedDates

Esta es la fecha o intervalo de fechas que elige el usuario. En el control, el usuario puede elegir un día, una semana o un mes, pero sólo puede seleccionar fechas continuas. También es posible establecer mediante programación las fechas seleccionadas; en este caso, podrá establecer fechas seleccionadas no contiguas.

Habilitar la selección de fechas

De forma predeterminada, el calendario permite a los usuarios hacer clic en una fecha individual para seleccionarla. Si está utilizando el control como calendario de sólo lectura, puede deshabilitar la funcionalidad de selección de fechas.

Si se habilita la selección de fechas, cada día del calendario contiene un control LinkButton que desencadenará un evento al hacer clic. Si habilita la selección de semanas o meses, se agregará una columna de vínculos a la izquierda del calendario para permitir que el usuario especifique qué semana se va a seleccionar.

Personalizar la apariencia del calendario

Puede establecer las propiedades de calendario para cambiar los colores, el tamaño, el texto y otras características visuales del calendario. Existen varias maneras de llevar a cabo esta operación, como puede verse en la tabla siguiente.

Método de personalización

Descripción

Establecer propiedades

Puede establecer las propiedades de forma que se muestren líneas de cuadrícula, cambie el día que aparece como primer día de la semana y cambie la apariencia del mes y los nombres de los días.

Establecer propiedades de estilo extendido

Puede utilizar propiedades derivadas del objeto Style para definir la apariencia de elementos concretos del calendario, como la fecha actual o la barra de título que contiene los vínculos de mes y de desplazamiento. Estas propiedades de estilo son compatibles con los exploradores que pueden utilizar hojas de estilos en cascada; existe un conjunto reducido de estilos de apariencia para exploradores más antiguos.

Personalizar la representación de días individuales

Cuando el control representa días individuales, desencadena un evento que puede controlarse para modificar la secuencia que se representa en el explorador. Esto no sólo es útil para cambiar la apariencia de los días, sino también para incluir contenidos personalizados en cada uno de los días. Para obtener información detallada, vea Cómo: Personalizar días aislados en un control Calendar de servidor Web.

Capturar la interacción del usuario con el control Calendar de servidor Web

El control Calendar desencadena el evento SelectionChanged cuando el usuario selecciona una fecha individual o un intervalo de fechas, y el evento VisibleMonthChanged cuando el usuario se desplaza a un nuevo mes. Al crear métodos para estos eventos, puede determinar qué día o qué fechas seleccionó el usuario y responder de forma adecuada. Una respuesta puede consistir en personalizar la presentación de esa fecha.

Mostrar información de una base de datos en el control Calendar

Un escenario común consiste en mostrar en el calendario información procedente de una base de datos. Por ejemplo, un calendario de acontecimientos suele basarse en información almacenada en una base de datos.

El control Calendar no admite directamente el enlace de datos; es decir, no es posible enlazar el calendario como una unidad con un origen de datos. En lugar de hacer esto, deberá crear un método para el evento DayRender del control, que se desencadena cuando se representa cada uno de los días del mes de calendario actual. En el método para este evento, es posible extraer información de un origen de datos y agregarla a la secuencia que se envía al explorador. Para obtener información detallada, vea Cómo: Mostrar las fechas seleccionadas de una base de datos en el control Calendar.

Accesibilidad

Para facilitar a los usuarios de los dispositivos de ayuda el acceso al control Calendar, este control admite una propiedad denominada UseAccessibleHeader. Cuando esta propiedad se establece en true (que es la configuración predeterminada), los encabezados de las columnas que contienen los nombres de los días se representan mediante los elementos HTML th.

Vea también

Tareas

Cómo: Personalizar días aislados en un control Calendar de servidor Web

Cómo: Seleccionar fechas mediante programación en un control Calendar de servidor Web

Cómo: Mostrar las fechas seleccionadas de una base de datos en el control Calendar