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 |
---|---|
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. |
|
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. |
|
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
Como: Controle de navegação de mês em um controle calendário do servidor Web
Como: Controle usuário data seleção in a calendário controle de servidor Web
Como: Personalizar a aparência do controle calendário servidor Web
Como: Personalizar dias individuais em um calendário controle de servidor Web
Como: Formato calendário controle de servidor Web elementos usando estilos
Como: Responder a data seleção in um calendário controle de servidor Web
Como: Ler datas selecionadas no calendário controle de servidor Web
Como: Selecionar datas por programação em um controle calendário do servidor Web
Como: conjunto data de hoje por programação em um controle calendário do servidor Web
Como: Exibir datas selecionadas de um banco de dados no controle calendário
Voltar ao topo
Referência de Classe
A tabela seguinte lista as classes que estão relacionadas ao controle Calendar.
Membro |
Descrição |
---|---|
A classe principal para o controle. |
|
A classe que representa uma data no controle Calendar. |
|
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