Calendar Web サーバー コントロールの概要

更新 : 2007 年 11 月

Calendar Web サーバー コントロールを使用すると、選択可能な日付をカレンダーに表示し、特定の日付に関連付けられたデータを表示できます。

このトピックの内容は次のとおりです。

• シナリオ

• 機能

• 背景

• コード例

• クラス リファレンス

シナリオ

Calendar Web サーバー コントロールを使用すると、以下の操作を行うことができます。

• 日付の表示と選択   任意の年の任意の日付に移動できるカレンダーを表示します。SelectedDate プロパティを設定すると、コントロールで特定の日付を強調表示できます。特定の日付をクリックしたり、表示する月を変更したりして、特定の日付に移動することもできます。カレンダーは、週単位または月単位で複数の日付を選択できるように設定できます。

  Calendar コントロールによる 10 月の月表示
  

• カレンダーのグリッドへの予約情報などの表示   Calendar コントロールでは、作業のリストや予定などの情報を日単位で詳細表示できます。この機能を使用すると、データベースから特定の日の情報を取得して、カレンダーに表示できます。

ページのトップへ

機能

Calendar コントロールを使用すると、以下の操作を行うことができます。

• ユーザーが日付や日付の範囲を選択するときなどに、ユーザーとの対話をキャプチャします。

• カレンダーの表示形式をカスタマイズします。

• データベースの情報をカレンダーに表示します。

ページのトップへ

背景

Calendar コントロールは 1 か月分の日付 (計 6 週間) を一度に表示します。このコントロールがサポートしている日付の種類を次の表に示します。

Calendar コントロールは、DateTime オブジェクトに基づいているため、このオブジェクトで許可されているすべての日付をサポートします。実際には、西暦 0 ～ 9999 年の範囲のすべての日付を表示できます。

ASP.NET ページでは、Calendar コントロールは HTML テーブルとして表示されます。したがって、コントロールの一部のプロパティが、テーブルの書式指定に使用されます。以前のブラウザでは、これらのプロパティの一部がサポートされていないことがあります。このため、以前のブラウザでは利用できない書式もあります。

日付選択機能の有効化

既定では、カレンダーの特定の日付をクリックして選択できます。コントロールを読み取り専用カレンダーとして使用する場合は、日付選択機能を無効にできます。

日付選択機能が有効な場合は、カレンダーの日付ごとに LinkButton コントロールが配置され、クリックするとイベントが発生します。週選択または月選択を有効にすると、カレンダーの端にリンク欄が表示され、週を選択できます。

カレンダーの表示形式のカスタマイズ

カレンダーのプロパティを設定することによって、カレンダーの色、サイズ、テキストなどを変更できます。表示形式を変更する方法を次の表に示します。

Calendar Web サーバー コントロールとユーザーとの対話のキャプチャ

ユーザーが特定の日付または日付の範囲を選択すると、Calendar コントロールは SelectionChanged イベントを発生させます。ユーザーが別の月を表示したときには、VisibleMonthChanged イベントを発生させます。このイベントを処理するメソッドを作成することで、ユーザーが選択した日付を特定して適切な応答を行うことができます。たとえば、日付表示のカスタマイズを行います。

データベースから Calendar コントロールへの情報表示

一般的には、データベースから取得した情報をカレンダーに表示します。たとえば、データベースに格納されている情報を基にして、行事カレンダーが作成されることがよくあります。

Calendar コントロールはデータ バインディングを直接サポートしていません。つまり、カレンダー全体をまとめて 1 つのデータ ソースにバインドすることはできません。代わりに、コントロールの DayRender イベントを処理するメソッドを作成します。このイベントは、現在カレンダーに表示されている月のそれぞれの日が表示されるときに発生します。このイベントを処理するハンドラで、データ ソースから情報を抽出し、ブラウザに表示するストリームに追加できます。詳細については、「方法 : データベースで選択した日付を Calendar コントロールに表示する」を参照してください。

ユーザー補助

補助デバイスを使用しているユーザーにとってより使いやすくなるように、Calendar コントロールは UseAccessibleHeader という名前のプロパティをサポートしています。このプロパティに true (既定値) を設定すると、曜日名を含む列見出しが HTML th 要素を使用して表示されます。

ページのトップへ

コード例

• 方法 : Calendar Web サーバー コントロールにおける表示月の移動を制御する

• 方法 : Calendar Web サーバー コントロールにおけるユーザーの日付選択を制御する

• 方法 : Calendar Web サーバー コントロールの表示形式をカスタマイズする

• 方法 : Calendar Web サーバー コントロールにおける日単位のカスタマイズ

• 方法 : スタイルを使用して、Calendar Web サーバー コントロール要素の表示形式を指定する

• 方法 : Calendar Web サーバー コントロールにおける日付選択に応答する

• 方法 : Calendar Web サーバー コントロールで選択された日付を読み取る

• 方法 : Calendar Web サーバー コントロールでプログラムによって日付を選択する

• 方法 : Calendar Web サーバー コントロールに今日の日付をプログラムで設定する

• 方法 : データベースで選択した日付を Calendar コントロールに表示する

ページのトップへ

クラス リファレンス

Calendar コントロールに関連するクラスの一覧を次の表に示します。

ページのトップへ

参照

処理手順

方法 : Calendar Web サーバー コントロールでプログラムによって日付を選択する

方法 : データベースで選択した日付を Calendar コントロールに表示する

その他の技術情報

ASP.NET Web サーバー コントロールの操作