ASP.NET - Calendar Web 服務器控件概述（上）

2019-11-17 04:02:14

字體：大中小

來源：轉載

供稿：網友

     可使用 Calendar Web 服務器控件顯示日歷中的可選日期，并顯示與特定日期關聯的數據。

一、方案

可以使用 Calendar Web 服務器控件執行下面的操作：

1、顯示和選擇日期   該控件顯示一個日歷，用戶通過此日歷可移動到任意一年中的任意一天。設置 SelectedDate 屬性，使某個特定的日期在控件中突出顯示。用戶還可通過單擊一個日或在不同的月份之間移動以移動到任意日期。還可將日歷配置為允許用戶選擇多個日期，包括整周或整月。

顯示十月份的 Calendar 控件的表示方法

      2、在日歷網格中顯示約會或其他信息   Calendar 控件可顯示個別日的特定詳細信息，如任務列表、事件時間表或類似的信息。此功能使您可以顯示數據庫中的日信息。

二、功能

可以使用 Calendar 控件執行下面的操作：

·捕獲用戶交互（例如在用戶選擇一個日期或一個日期范圍時）。

·自定義日歷的外觀。

·在日歷中顯示數據庫中的信息。

三、背景

Calendar 控件一次顯示一個月份中的日期，同時共顯示六周。該控件支持若干種日期類型，下表描述了這些日期類型。

日期類型
說明

TodaysDate
默認情況下，將它設置為與服務器上的當前日期匹配。但是，可調整它以顯示不同區域設置的正確日期。

VisibleDate
此日期確定日歷中顯示哪個月份。在日歷中，用戶可在不同的月份之間移動，這將在不影響當前日期的情況下更改可視日期。通過以編程方式設置可視日期，可定位到不同的月份。

SelectedDate, SelectedDates
這是用戶選擇的日期或日期范圍。在該控件中，用戶可選擇單個日、單個周或單個月份，但只能選擇連續的日期。也可以以編程方式設置選定的日期。在這種情況下，可設置非連續的選定日期。

      Calendar 控件基于 DateTime 對象，因此支持該對象所允許的全部日期范圍。您可有效地顯示公元 0 年到 9999 年之間的任意日期。

在 asp.net 頁上，Calendar 控件以 HTML 表的形式呈現。因此，該控件的一些屬性與表的各種格式設置有關。一些較早的瀏覽器不完全支持其中的幾個屬性。因此，并不是所有的格式設置功能在這些瀏覽器中都可用。

      1、啟用日期選定

默認情況下，日歷允許用戶單擊個別日期以選定它。如果正在將控件用作只讀日歷，則可禁用日期選擇功能。

如果啟用了日期選擇，則日歷的每一天都包含一個 LinkButton 控件，當單擊該控件時，會引發某個事件。如果啟用了周選擇或月份選擇，則將一列鏈接添加到日歷的一側，以使用戶能夠指定要選擇的周。

2、自定義日歷的外觀

可設置日歷的屬性以更改日歷的顏色、尺寸、文本以及其他可視特性。有幾種方法可實現此操作，如下表所示。

自定義方法
說明

設置屬性
可設置屬性以顯示網格線，更改顯示為一周的第一天的日，更改月份和日名稱的外觀。

設置擴展樣式屬性
可使用從 Style 對象派生的屬性來設置日歷中的特定元素的外觀。這包括當前日期或包含月份和導航鏈接的標題欄。可使用級聯式樣式表的瀏覽器支持這些樣式屬性。而較早的瀏覽器只支持其中的一部分外觀樣式。

自定義個別日的呈現
當控件在呈現個別日時會引發一個事件，您可處理該事件以修改所呈現的流。這不僅對于更改日的外觀有用，而且對于包含每個日的自定義內容也很有用。

      3、捕獲用戶與 Calendar Web 服務器控件之間的交互

當用戶選擇單個日期或日期范圍時，Calendar 控件引發 SelectionChanged 事件。當用戶顯示一個新月份時，該控件引發 VisibleMonthChanged 事件。通過為這些事件創建方法，可確定用戶選定了哪個日期或哪些日期并進行適當的響應。一種響應可能是自定義該日期的顯示。

4、在 Calendar 控件中顯示數據庫信息

一個常用的方案是在日歷中顯示數據庫信息。例如，一個事件日歷通常基于在數據庫中存儲的信息。

Calendar 控件并不直接支持數據綁定，即您不是將日歷作為一個整體綁定到數據源。相反，您為控件的 DayRender 事件創建一個方法，該事件在呈現當前日歷月份中的每個日時引發。在該事件的處理程序中，您可從數據源中提取信息，并將這些信息添加到瀏覽器中呈現的流。

5、輔助功能

為使輔助設備的用戶能更方便地訪問 Calendar 控件，該控件支持名為 Use accessibleHeader 的屬性。當此屬性設置為 true 時（默認設置），會使用 HTML th 元素呈現包含日名稱的列標題。

四、如何：在 Calendar Web 服務器控件中控制月份定位

      默認情況下，日歷 (Calendar) 控件顯示包含當前日期的月份。通過單擊日歷標題欄中的月導航鏈接，用戶可以在 Calendar 控件的不同月份間移動。您可以控制這些鏈接是否可供用戶單擊。

您還可以編程方式定位，這在您想為用戶提供另一種顯示特定月份的方法時很有用。最后，您可響應在用戶定位時引發的事件。

      1、啟用或禁用用戶月份定位

將 Calendar 控件的 ShowNextPRevMonth 屬性設置為 true 或 false。如果該屬性設置為 false，則控件不在標題中顯示允許用戶在月份之間移動的 LinkButton 控件。

提示：通過設置 NextMonthText、PrevMonthText、NextPrevFormat 和 NextPrevStyle 屬性，可以更改月份定位超鏈接的外觀。

      2、以編程方式定位月份

將控件的 VisibleDate 屬性設置為要顯示的月份中的某個日期。該日期可以是此月份中的任意一天，但通常設置為此月份中的第一天。如果 VisibleDate 屬性為空（如果設置為 DateTime.Empty），則當前可見月份從 TodaysDate 屬性的值獲取。

下例定位到 2000 年 2 月：

Calendar1.VisibleDate = new DateTime(2000, 2, 1);

更改 VisibleDate 屬性對 TodaysDate、SelectedDayStyle 或 SelectedDates 屬性的值沒有影響。

如果啟用月份定位，則日歷 (Calendar) 控件將在用戶移動到另一個月份時引發一個事件。您可處理該事件以替換或修正默認的月份定位。例如，如果在一個旅行計劃頁上使用兩個 Calendar 控件，則可以防止用戶在設置起始日期月份之前設置結束日期月份。

      3、響應月份定位事件

為控件的 VisibleMonthChanged 事件創建一個方法。當該事件引發時，控件已經將 VisibleMonth 屬性值增加或減少了 1。

VisibleMonthChanged 事件采用一個 MonthChangedEventArgs 類型的參數。您可使用該參數的如下屬性確定或重寫用戶的操作：

屬性
說明

PreviousDate
在用戶單擊月份定位按鈕之前顯示的月份值。可以將該屬性的值與控件的 VisibleMonth 屬性值進行比較，以確定用戶的定位方向。若要取消用戶單擊的效果，請將控件的 VisibleDate 屬性設置為該值。

NewDate
用戶已經定位到的月份值。在 VisibleDate 事件引發前，VisibleMonthChanged 屬性更新為該值。

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));

}

五、如何：控制 Calendar Web 服務器控件中的用戶日期選定

      您可指定用戶可在 Calendar 控件中選定個別日、個別周或整個月份。您也可以完全禁用日選定。

1、控制用戶日期選定

將 Calendar 控件的 SelectionMode 屬性設置為在 SelectionMode 枚舉中定義的一個值：Day、DayWeek 或 DayWeekMonth。若要禁用所有日期選定，請將該屬性設置為 None。

說明：用戶只可選定單個日、單個周或整個月份。但是，在代碼中您可選定任意一組日期。

當啟用日期選定時，只要用戶選定一天、一周或一個月，就會提交窗體并引發一個事件，您可為該事件創建一個方法。

為允許用戶選定一個日期，日歷將顯示鏈接。個別日包含帶有日期編號的鏈接。如果將日歷設置為允許用戶選定一周或整個月份，日歷的左側會額外添加一個帶有選定鏈接的列。

說明：您還可以控制個別日的日期選定。例如，您可指定用戶可單擊該月份的特定日，如假日。

您可為周和月份選定鏈接指定文本。

      2、指定周和月份選定鏈接文本

將 SelectWeekText 和 SelectMonthText 屬性設置為用于導航鏈接的文本。

還可以為包含周和月份選定鏈接的列設置字體、顏色和邊框樣式，以及為日設置樣式。

上一篇：ASP.NET MVC學習筆記-Controller的ActionResult

下一篇：C# richTextBox顯示不同顏色文字