Desenvolvimento - ASP. NET
ASP.NET: Visão Geral do controle Calendar
O controle Calendar permite inserir um calendário em um Web Form, veja como nunca foi tão fácil inserir um calendário em uma página web.
por Cristian Arrano TownsendBom, falando sério agora, o controle Calendar permite inserir um calendário em um Web Form. Nunca foi tão fácil inserir um calendário em uma página. Quem desenvolve em web antes do asp.net sabe o quanto era doloroso misturar aquela quantidade enorme de código asp (ou javascript) em uma página e depois integrar na nossa aplicaçao. Bom, pois seus problemas acabaram....
O controle permite a seleção de um determinado dia, semana, mes ou até mesmo alguns dias.
O layout do controle é 100% customizável e gera tabelas HTML. Nada de ActiveX.
A figura abaixo mostra o controle e seus principais elementos.
Abaixo é mostrada uma tabela com as principais propriedades do controle Calendar
Propriedade | Descrição |
CellPadding | Especifica a distancia em pixels entre a borda e o conteúdo da célula |
CellSpacing | Especifica a largura em pixles entre as celulas do controle |
DayHeaderStyle | Especifica as propriedades de estilo da seção onde os dias da semana são mostrados. Funciona somente se a propriedade ShowDayHeader é True. |
DayNameFormat | Especifica o formato dos nomes para os dias da semana. Pode ser: FirstLetter, FirstTwoLetters, Full ou Short (default). |
DayStyle | Especifica as propriedades dos dias do mes. |
FirstDayOfWeek | Especifica o dia semana a ser mostrado na primeira coluna do controle. |
NextMonthText | Especifica o texto para o elemento de navegação para seleção do próximo mes. O valor por default é (>) |
NextPrevFormat | Especifica o formato do texto para os elementos de navegação que seleciona o mes anterior e o proximo do calendario. |
NextPrevStyle | Define o estilo para os elementos de navegação do mes anterior e do proximo. |
OtherMonthDayStyle | Especifica o estilo para os dias que nao pertencem ao mes mostrado. |
PrevMonthText | Especifica o texto para os elementos de navegação para o mes anterior. O valor padrao é (<). |
SelectedDate | Especifica a data selecionada. |
SelectedDates | Especifica uma coleção de datas selecionadas. |
SelectedDayStyle | Especifica o estilo para o dia selecionado no controle |
SelectionMode | Especifica o modo de seleção de datas. Os valores podem ser: Day, DayWeek e DayWeekMonth. |
SelectMonthText | Especifica o texto para a seleção do mes. O valor padrao é (>>). |
SelectorStyle | Especifica o estilo para a seleção da semana e mes. |
SelectWeekText | Especifica o texto para a seleção da semana. O valor padrao é (>) |
ShowDayHeadder | Indica se mostra o nome do dia da semana. O valor padrao é True. |
ShowGridLines | Indica se a tabela é separada por linhas. |
ShowNextPrevMonth | Indica se os elementos de nevegação por mes é mostrado ou nao. |
ShowTitle | Indica se é mostrado ou nao o titulo do controle |
TitleFormat | Especifica o formato do titulo do controle. Pode ser Month ou MonthYear. |
TitleStyle | Especifica o estilo para o titulo do controle. |
TodayDayStyle | Especifica o estilo para a data atual no controle |
TodaysDate | Especifica o dia de hoje no controle. |
VisibleDate | Especifica o mes a ser mostrado no controle dependendo no valor desta propriedade. |
WeekendDayStyle | Especifica o estilo para os dias do fim de semana no controle. |
Eventos do controle
Evento | Descriçao |
DayRender | Ocorre quando é criado o controle. Este evento ocorre depois que o controle é criado, mas antes da página ser renderizada. |
SelectionChanged | Ocorre quando o usuario muda a seleção do controle. |
VisibleMonthChanged | Ocorre quando a seleção do mes é mudada quando o usuario faz um click nos elementos mes anterior e proximo. |
Um exemplo
Bom pessoal, chegou a hora de criar um exemplo.
- Crie um novo Web Form no Visual Studio .NET chamado exemploCalendar.aspx
- Insira um controle do tipo Calendar no Web Form. (ToolBox -> Web Controls)
- Insira 1 label, com ID=lblMessage.
- Configure a propriedade NextPrev do Calendar para ShortMonth, a propriedade SelectMonthText para Month e a propriedade SelectWekkText para Week.
- No code-behind, insira a seguinte linha: Imports System.Text
- Fazendo um duplo clique no controle, vamos inserir o código mostrado abaixo;
Private Sub Calendar1_SelectionChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Calendar1.SelectionChanged Dim sbMessage As New StringBuilder sbMessage.Append("A(s) data(s) selecionada(s) sao:
") Dim i As Integer For i = 0 To Me.Calendar1.SelectedDates.Count - 1 sbMessage.Append(Me.Calendar1.SelectedDates(i).ToShortDateString & "
") Next Me.lblMessage.Text = sbMessage.ToString End Sub
O exemplo ficará como é mostrado na figura abaixo.
Abraços a todos.