Share via


Visão geral sobre controle do Servidor Web de calendário

O controle Calendar de servidor Web pode ser usado para exibir datas selecionáveis em um calendário e para exibir os dados associados com datas específicas.

Esse tópico contém:

  • Cenários

  • Recursos

  • Segundo plano

  • Exemplos de código

  • Referência de Classe

Cenários

Você pode usar o controle Calendar de servidor Web para fazer o seguinte:

  • Exibir e selecionar as datas O controle exibe um calendário através do qual os usuários podem mover para qualquer dia em qualquer ano.Definir a propriedade SelectedDate faz uma data específica ser realçada no controle.Opcionalmente, os usuários podem mover para datas arbitrárias, clicando em um dia ou movendo de mês para mês.O calendário pode ser configurado para permitir que os usuários selecionem várias datas, tanto uma semana inteira ou um mês inteiro.

    Uma representação de controle de calendário exibindo do mês de outubro

  • Exibir compromissos ou outras informações em uma grade de calendárioO controle Calendar pode exibir detalhes específicos para dias individuais, como uma lista de tarefas, uma agenda de eventos, ou informações semelhantes.Este recurso permite que você exiba informações do dia a partir de um banco de dados.

Voltar ao topo

Recursos

Você pode usar o Calendar para fazer o seguinte:

  • Capture interação do usuário, quando um usuário seleciona uma data ou um intervalo de datas.

  • Personalize a aparência do calendário.

  • Exibir informações de um banco de dados no calendário.

Voltar ao topo

Segundo plano

O controle Calendar exibe as datas de um mês de cada vez, com um total de seis semanas aparecendo ao mesmo tempo.O controle oferece suporte a vários tipos de datas, que são descritas na tabela a seguir.

Tipo de data

Descrição

TodaysDate

Por padrão, isso é definido para corresponder à data atual no servidor.No entanto, você pode ajustá-lo para que a data seja exibida corretamente para um local diferente.

VisibleDate

Esta data determina qual mês aparece no calendário.O usuário pode mover de mês para mês no calendário, o qual altera a data visível sem afetar a data de hoje .Você pode navegar entre meses, definindo a data visível por meio de programação.

SelectedDate, SelectedDates

Este é o intervalo de datas ou data que o usuário escolhe.No controle, o usuário pode selecionar um único dia, semana ou mês, mas só pode selecionar datas contíguas.Você pode definir as datas selecionadas também por meio de programação.Nesse caso, você pode definir datas selecionadas não contíguas.

O controle Calendar é baseado no objeto DateTime e, portanto, dá suporte ao intervalo completo de datas que é permitido por esse objeto.Na verdade, você pode exibir qualquer data entre os anos 0 e 9999 d.c.

Em um página ASP.NET, o controle Calendar é processado como uma tabela HTML.Portanto, algumas propriedades do controle pertencem aos vários aspectos da formatação da tabela.Algumas dessas propriedades não são totalmente suportadas em alguns navegadores mais antigos.Portanto, nem todos os recursos de formatação estarão disponíveis nesses navegadores.

Ativar seleção de data

Por padrão, o calendário permite que os usuários cliquem em uma data individual para selecioná-la.Se você estiver usando o controle como um calendário somente leitura, você pode desativar a funcionalidade de seleção de data.

Se a seleção de data estiver ativada, cada dia do calendário contém um controle LinkButton que gera um evento quando ele for clicado.Se você ativar seleção de semana ou mês, uma coluna de links é adicionada ao lado do calendário para permitir que o usuário especifique qual semana selecionar.

Personalizando a aparência do calendário.

Você pode definir propriedades de calendário para alterar as cores, tamanho, texto e outros recursos visuais do calendário.Há várias maneiras para fazer isso, conforme mostrado na tabela a seguir.

Método de personalização

Descrição

Definindo propriedades

Você pode definir propriedades para exibir linhas de grade, alterar qual dia é exibido como o primeiro dia da semana e alterar a aparência dos nomes de mês e dia.

Definindo propriedades de estilo estendidas

Você pode usar as propriedades derivadas do objeto Style para definir a aparência de determinados elementos no calendário.Isso inclui a data atual ou a barra de título que contém os links de navegação e mês.Essas propriedades de estilo têm suporte em navegadores que podem usar folhas de estilo em cascata.Um conjunto reduzido de estilos de aparência é suportado para navegadores mais antigos.

Personalizando o processamento de dias individuais

Como o controle processa dias individuais, ele gera um evento que você pode manipular a modificar o fluxo que está sendo processado.Isso é útil não apenas para alterar a aparência de dias, mas para incluir conteúdo personalizado em cada dia.Para obter detalhes, consulte:Como: Personalizar dias individuais em um calendário controle de servidor Web.

Capturando interação do usuário com o controle do servidor da Web do calendário

O controle Calendar gera o evento SelectionChanged quando o usuário seleciona uma data individual ou um intervalo de datas.Ele gera o evento VisibleMonthChanged quando o usuário exibe um novo mês.Ao criar métodos para esses eventos, você pode determinar qual data ou datas o usuário selecionou e responder de forma apropriada.Uma resposta pode ser para personalizar a exibição dessa data.

Exibindo informações de um banco de dados no controle de calendário

Um cenário comum é exibir informações de um banco de dados no calendário.Por exemplo, um calendário de eventos é frequentemente baseado nas informações que são armazenadas em um banco de dados.

O controle Calendar não oferece suporte direto à associação de dados — ou seja, você não vincula o calendário como um todo com uma fonte de dados.Em vez disso, você cria um método para o evento DayRender do controle, que é gerado quando cada dia no mês do calendário atual está sendo processado.No manipulador para este evento, você pode extrair informações de uma fonte de dados e adicioná-lo ao fluxo que está sendo processado para o navegador.Para obter detalhes, consulte:Como: Exibir datas selecionadas de um banco de dados no controle calendário.

Acessibilidade

Para tornar o controle Calendar mais acessível aos usuários de dispositivos auxiliares, o controle suporta uma propriedade chamada UseAccessibleHeader.Quando essa propriedade é definida como true (que é a configuração padrão), os títulos de colunas que contêm os nomes dos dias são processados usando elementos HTML th.

Voltar ao topo

Exemplos de código

Voltar ao topo

Referência de Classe

A tabela seguinte lista as classes que estão relacionadas ao controle Calendar.

Membro

Descrição

Calendar

A classe principal para o controle.

CalendarDay

A classe que representa uma data no controle Calendar.

CalendarSelectionMode

Uma enumeração que representa os modos de seleção de data disponíveis no controle Calendar.

Voltar ao topo

Consulte também

Tarefas

Como: Selecionar datas por programação em um controle calendário do servidor Web

Como: Exibir datas selecionadas de um banco de dados no controle calendário

Outros recursos

Trabalhando com Controles de Servidor Web do ASP.NET