Como: Controle de navegação de mês em um controle calendário do servidor Web

Artigo
10/15/2014

Por padrão, o calendário exibe o mês que contém a data de hoje.Os usuários podem mover de mês a mês no Calendar controlar, clicando em links de navegação do mês na BAR de título do calendário. Você pode controlar se esses links estão disponíveis para o usuário clicar.

Você também pode navegar por meio de programação, que é útil se você desejar fornecer um modo alternativo para os usuários exibirem um mês específico.Finalmente, você pode responder a um evento gerado enquanto o usuário navega.

Para ativar ou desativar navegação por mês pelo usuário.

Definir a propriedade ShowNextPrevMonth do controle Calendar para true ou false.Se a propriedade for false, o controle não exibe os controles LinkButton no título, que permitem que um usuário se mova entre meses.

Dica:

Você pode alterar a aparência dos hiperlinks de navegação do mês, definindo o NextMonthText, PrevMonthText, NextPrevFormat, e NextPrevStyle Propriedades.

Dica:
Você pode alterar a aparência dos hiperlinks de navegação do mês, definindo o NextMonthText, PrevMonthText, NextPrevFormat, e NextPrevStyle Propriedades.

Para navegar pelos meses por meio de programação

Definir a propriedade VisibleDate do controle para uma data no mês que você deseja exibir.A data pode ser qualquer dia dentro desse mês mas normalmente é definida para o primeiro dia do mês.Se a propriedade VisibleDate está vazia (se ela estiver definida como DateTime.Empty), o mês visível no momento é derivado do valor da propriedade TodaysDate.

O exemplo a seguir navega para fevereiro de 2000:
```
Calendar1.VisibleDate = New Date(2000, 2, 1)
```
```
Calendar1.VisibleDate = new DateTime(2000, 2, 1);
```
Alterar a propriedade VisibleDate não tem efeito sobre os valores das propriedades TodaysDate, SelectedDayStyle ou SelectedDates.

Se a navegação por mês estiver ativada, o controle gera um evento quando o usuário move para outro mês.Você pode manipular esse evento para substituir ou corrigir a navegação por mês padrão.Por exemplo, se você estiver usando dois controles Calendar em uma página de planejamento de viagem, você pode impedir que o usuário defina o mês data de início depois do mês da data de término.

Para responder a um evento de navegação por mês

Criar um método para o evento VisibleMonthChanged do controle.Quando este evento é gerado, o controle já alterou a propriedade VisibleMonth em 1.

O evento VisibleMonthChanged leva um único argumento do tipo MonthChangedEventArgs.Você pode usar as seguintes propriedades deste argumento para determinar ou substituir o que o usuário está fazendo:

Propriedade	Descrição
PreviousDate	O valor do mês que foi exibido antes de o usuário clicar um botão de navegação por mês.Você pode comparar o valor desta propriedade com a propriedade VisibleMonth do controle para determinar a direção na qual o usuário está navegando.Para cancelar o efeito de clique do usuário, defina a propriedade VisibleDate do controle para este valor.
NewDate	O valor do mês para o qual o usuário navegou.A propriedade VisibleDate é atualizada para este valor antes do evento VisibleMonthChanged ser gerado.

Public Sub Calendar1_VisibleMonthChanged(ByVal sender As Object, _
   ByVal e As System.Web.UI.WebControls.MonthChangedEventArgs) _
   Handles Calendar1.VisibleMonthChanged

   ' Select the 10th and 25th of each month.
   Calendar1.SelectedDates.Clear()
   Calendar1.SelectedDates.Add(New DateTime(e.NewDate.Year, e.NewDate.Month, 10))
   Calendar1.SelectedDates.Add(New DateTime(e.NewDate.Year, e.NewDate.Month, 25))
End Sub

private void Calendar1_VisibleMonthChanged (object sender, 
   System.Web.UI.WebControls.MonthChangedEventArgs e)
{
     // Select the 10th and 25th of each month.
     Calendar1.SelectedDates.Clear();
     Calendar1.SelectedDates.Add(new DateTime(e.NewDate.Year, e.NewDate.Month, 10));
     Calendar1.SelectedDates.Add(new DateTime(e.NewDate.Year, e.NewDate.Month, 25));
}

Consulte também

Conceitos

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

Compartilhar via