controle de servidor Web Declarative sintaxe do calendário
Exibe um calendário de um mês que permite ao usuário selecionar datas e mover para o mês anterior ou seguinte.
<asp:Calendar
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
Caption="string"
CaptionAlign="NotSet|Top|Bottom|Left|Right"
CellPadding="integer"
CellSpacing="integer"
CssClass="string"
DayNameFormat="Full|Short|FirstLetter|FirstTwoLetters|Shortest"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
FirstDayOfWeek="Sunday|Monday|Tuesday|Wednesday|Thursday|Friday|
Saturday|Default"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
NextMonthText="string"
NextPrevFormat="CustomText|ShortMonth|FullMonth"
OnDataBinding="DataBinding event handler"
OnDayRender="DayRender event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSelectionChanged="SelectionChanged event handler"
OnUnload="Unload event handler"
OnVisibleMonthChanged="VisibleMonthChanged event handler"
PrevMonthText="string"
runat="server"
SelectedDate="string"
SelectionMode="None|Day|DayWeek|DayWeekMonth"
SelectMonthText="string"
SelectWeekText="string"
ShowDayHeader="True|False"
ShowGridLines="True|False"
ShowNextPrevMonth="True|False"
ShowTitle="True|False"
SkinID="string"
Style="string"
TabIndex="integer"
TitleFormat="Month|MonthYear"
ToolTip="string"
UseAccessibleHeader="True|False"
Visible="True|False"
VisibleDate="string"
Width="size"
>
<DayHeaderStyle/>
<DayStyle/>
<NextPrevStyle/>
<OtherMonthDayStyle/>
<SelectedDayStyle/>
<SelectorStyle/>
<TitleStyle/>
<TodayDayStyle/>
<WeekendDayStyle/>
</asp:Calendar>
Comentários
The Calendar controle é usado para exibir um calendário de um mês que permite ao usuário selecionar datas e mover para os meses próximo e anteriores.
By configuração the SelectionMode propriedade, você pode especificar se o usuário pode selecionar um único dia, uma semana ou mês, ou você pode desabilitar a seleção de data inteiramente.
configuração as propriedades de estilo para diferentes partes do controle personaliza a aparência do Calendar controle. A tabela a seguir lista as propriedades de estilo diferentes para o Calendar controle.
Objeto de estilo |
Descrição |
Classe de estilo |
|---|---|---|
O estilo para a seção do calendário em que os nomes dos dias da semana são exibidos. |
||
O estilo para os dias individuais no mês exibido. .gif "Observação") Observação:
Finais de semana, a data corrente e o dia selecionado podem ter diferentes estilos, definindo o WeekendDayStyle, TodayDayStyle, and SelectedDayStyleproperties, respectively.
|
||
O estilo de seções nas extremidades esquerdas e direita do título de onde da BAR de navegação do mês LinkButton controles estão localizados. |
||
O estilo para os dias da anterior e próximo mês que aparecem na exibição de mês corrente. |
||
O estilo para a data selecionada. Observação:
Se esta propriedade não estiver definido, o estilo especificado pela DayStyle propriedade é usada para exibir a data selecionada.
|
||
O estilo para a coluna à esquerda do Calendar controle contendo links para a seleção de uma semana ou mês inteiro. |
||
O estilo para o BAR de título na parte superior do calendário que contém o nome do mês e links de navegação do mês. Observação:
Se NextPrevStyle esteja configurado, ele substitui o estilo para o mês seguinte e anterior controles de navegação localizados nas extremidades da BAR de título.
|
||
O estilo para a data corrente. Observação:
Se esta propriedade não estiver definido, o estilo especificado pela DayStyle propriedade é usada para exibir a data corrente.
|
||
O estilo para os dias de final de semana. Observação:
Se esta propriedade não estiver definido, o estilo especificado pela DayStyle propriedade é usada para exibir as datas de fim de semana.
|
Você também pode controlar a aparência do Calendar controlar, exibir ou ocultar diferentes partes do controle. A tabela a seguir lista as partes do Calendar controle que pode ser exibida ou oculto.
Propriedade |
Descrição |
|---|---|
Exibe ou oculta a seção que exibe os dias da semana. |
|
Exibe ou oculta as linhas de grade entre os dias do mês. |
|
Exibe ou oculta os controles de navegação para o mês anterior ou seguinte. |
|
Exibe ou oculta a seção do título. |
Embora vincular a uma fonte de dados não tem suporte no Calendar controle, você pode modificar o conteúdo e a formatação de células individuais de data. Antes do Calendar controle é exibido na página da Web, ele cria e monta os componentes que compõem o controle. The DayRender evento é disparado quando cada data de células em Calendar controle é criado. Você pode controlar o Sumário e a formatação de uma célula de data sistema autônomo ela é criada, fornecendo código no manipulador de eventos para o DayRender evento.
Observação: The Calendar controle processa JavaScript no navegador cliente. O navegador do cliente deve ter o JavaScript habilitado para este controle para funcionar corretamente. Para obter mais informações sobre script de cliente, consulte Script de Cliente em Páginas da Web ASP.NET
Para obter informações sobre as propriedades com suporte para cada classe de estilo, consulte Propriedades do objeto de estilo.
Para obter informações detalhadas sobre o Calendar Propriedades do controle e eventos, consulte o Calendar documentação da classe.
Exemplo
The following example shows a sample declaration for a Calendarcontrol in an .aspx file. A declaração inclui uma série de propriedades do objeto de estilo e estabelece o Date_Selected o método sistema autônomo o manipulador para o SelectionChanged evento.
<asp:Calendar id="Calendar2"
OnSelectionChanged="Date_Selected"
SelectionMode="DayWeekMonth"
Font-Name="Verdana"
Font-Size="12px"
NextPrevFormat="ShortMonth"
SelectWeekText="week"
SelectMonthText="month"
runat="server">
<TodayDayStyle Font-Bold="True"/>
<DayHeaderStyle Font-Bold="True"/>
<OtherMonthDayStyle ForeColor="gray"/>
<TitleStyle BackColor="#3366ff"
ForeColor="white"
Font-Bold="True"/>
<SelectedDayStyle BackColor="#ffcc66"
Font-Bold="True"/>
<NextPrevStyle ForeColor="white"
Font-Size="10px"/>
<SelectorStyle BackColor="#99ccff"
ForeColor="navy"
Font-Size="9px"/>
</asp:Calendar>
O exemplo a seguir mostra um método de manipulação de eventos para um Calendar do controle SelectionChanged evento. Consultando o SelectedDates parâmetro das Calendar controle, você pode determinar quantos dias estão selecionados e, portanto, se o usuário seleciona um dia, semana ou mês. Informações sobre a seleção são exibidas em um Label Controle de servidor Web.
Sub Date_Selected(sender as Object sender, e As EventArgs)
Select (Calendar1.SelectedDates.Count)
Case 0: 'None
Label1.Text = "No dates are currently selected"
Case 1: 'Day
Label1.Text = "The selected date is " & _
Calendar1.SelectedDate.ToShortDateString
Case 7: 'Week
Label1.Text = "The selection is a week beginning " & _
Calendar1.SelectedDate.ToShortDateString
Case Else: 'Month
Label1.Text = "The selection is a month beginning " & _
Calendar1.SelectedDate.ToShortDateString
End Select
End Sub
protected void Date_Selected(object sender, EventArgs e)
{
switch (Calendar1.SelectedDates.Count)
{
case (0): //None
{
Label1.Text = "No dates are currently selected";
break;
}
case (1): //Day
{
Label1.Text = "The selected date is " +
Calendar1.SelectedDate.ToShortDateString();
break;
}
case (7): //Week
{
Label1.Text = "The selection is a week beginning " +
Calendar1.SelectedDate.ToShortDateString();
break;
}
default: //Month
Label1.Text = "The selection is a month beginning " +
Calendar1.SelectedDate.ToShortDateString();
break;
}
}
Consulte também
Conceitos
Visão geral sobre controle do Servidor Web de calendário
Controles de Servidor do ASP.NET