Calendar 웹 서버 컨트롤 선언 구문
업데이트: 2007년 11월
이 컨트롤에서는 사용자가 날짜를 선택하거나 이전 달과 다음 달로 이동할 수 있는 1개월 달력을 표시합니다.
<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>
설명
Calendar 컨트롤은 사용자가 날짜를 선택하고 이전 달과 다음 달로 이동하는 데 사용할 수 있는 1개월 달력을 표시하는 데 사용됩니다.
SelectionMode 속성을 설정하면 하루, 주 또는 달을 선택할 수 있도록 하거나 날짜를 선택할 수 없도록 지정할 수 있습니다.
컨트롤의 다양한 부분에 스타일 속성을 설정하여 Calendar 컨트롤의 모양을 사용자 지정할 수 있습니다. 다음 표에서는 Calendar 컨트롤의 다양한 스타일 속성을 보여 줍니다.
스타일 개체 |
설명 |
스타일 클래스 |
|---|---|---|
달력의 요일 표시 부분에 대한 스타일 |
||
표시된 달의 개별 날짜에 대한 스타일 참고 WeekendDayStyle, TodayDayStyle 및 SelectedDayStyle속성을 설정하여 각각 주말, 현재 날짜, 선택한 날짜를 서로 다른 스타일로 표시할 수 있습니다. |
||
달 탐색 LinkButton 컨트롤이 있는 제목 표시줄의 왼쪽과 오른쪽 끝 부분에 대한 스타일 |
||
현재 달 뷰에 나타나는 이전 달과 다음 달의 날짜에 대한 스타일 |
||
선택된 날짜에 대한 스타일 참고 이 속성을 설정하지 않으면 DayStyle 속성에 지정된 스타일을 사용하여 선택된 날짜를 표시합니다. |
||
주 또는 전체 달을 선택하기 위한 링크가 포함된 Calendar 컨트롤의 왼쪽 열에 대한 스타일 |
||
달 이름과 달 탐색 링크가 있는 달력 맨 위의 제목 표시줄에 대한 스타일 참고 NextPrevStyle을 설정하면 제목 표시줄의 끝에 있는 이전 달 및 다음 달 탐색 컨트롤에 대한 스타일이 재정의됩니다. |
||
현재 날짜에 대한 스타일 참고 이 속성을 설정하지 않으면 DayStyle 속성에 지정된 스타일을 사용하여 현재 날짜를 표시합니다. |
||
주말에 대한 스타일 참고 이 속성을 설정하지 않으면 DayStyle 속성에 지정된 스타일을 사용하여 주말 날짜를 표시합니다. |
Calendar 컨트롤의 다양한 부분을 표시하거나 숨기는 방식으로 컨트롤의 모양을 제어할 수도 있습니다. 다음 표에서는 표시하거나 숨길 수 있는 Calendar 컨트롤 부분을 보여 줍니다.
속성 |
설명 |
|---|---|
요일을 나타내는 부분을 표시하거나 숨깁니다. |
|
날짜 사이의 모눈선을 표시하거나 숨깁니다. |
|
이전 달과 다음 달로 이동하기 위한 탐색 컨트롤을 표시하거나 숨깁니다. |
|
제목 부분을 표시하거나 숨깁니다. |
Calendar 컨트롤에서는 데이터 소스에 대한 바인딩이 지원되지 않지만 개별 날짜 셀의 내용과 서식을 수정할 수 있습니다. Calendar 컨트롤은 웹 페이지에 표시되기 전에 컨트롤을 구성하는 구성 요소를 만들고 어셈블합니다. Calendar 컨트롤의 각 날짜 셀이 만들어질 때 DayRender 이벤트가 발생합니다. 날짜 셀을 만들 때 DayRender 이벤트에 대한 이벤트 처리기에서 코드를 작성하여 셀의 내용과 서식을 제어할 수 있습니다.
참고 Calendar 컨트롤은 클라이언트 브라우저에서 JavaScript를 렌더링합니다. 이 컨트롤이 제대로 작동하려면 클라이언트 브라우저에서 JavaScript를 사용할 수 있어야 합니다. 클라이언트 스크립트에 대한 자세한 내용은 ASP.NET 웹 페이지의 클라이언트 스크립트를 참조하십시오.
각 스타일 클래스에 지원되는 속성에 대한 자세한 내용은 Style 개체 속성을 참조하십시오.
Calendar 컨트롤의 속성과 이벤트에 대한 자세한 내용은 Calendar 클래스 설명서를 참조하십시오.
예제
다음 예제에서는 .aspx 파일에서 Calendar컨트롤을 선언하는 샘플을 보여 줍니다. 이 선언은 다양한 스타일 개체 속성을 포함하고 Date_Selected 메서드를 SelectionChanged 이벤트에 대한 처리기로 설정합니다.
<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>
다음 예제에서는 Calendar 컨트롤의 SelectionChanged 이벤트에 대한 이벤트 처리 메서드를 보여 줍니다. 이 경우 Calendar 컨트롤의 SelectedDates 매개 변수를 쿼리하면 선택된 날짜 수를 확인할 수 있으므로 사용자가 날짜, 주 또는 달 중에서 무엇을 선택하는지 알 수 있습니다. 선택 항목에 대한 정보는 Label 웹 서버 컨트롤에 표시됩니다.
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;
}
}