DayRenderEventArgsとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DayRenderEventArgs クラス

Calendar コントロールの DayRender イベントのデータを提供します。このクラスは継承できません。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 DayRenderEventArgs

Visual Basic (使用法)

Dim instance As DayRenderEventArgs

public sealed class DayRenderEventArgs

C++

public ref class DayRenderEventArgs sealed

public final class DayRenderEventArgs

JScript

public final class DayRenderEventArgs

解説

データ連結は Calendar コントロールではサポートされていませんが、各日付セルの内容と書式は変更できます。Calendar コントロールは、Web ページに表示される前に、構成要素であるコンポーネントを作成してアセンブルします。DayRender イベントは、Calendar コントロールの各日付セルが作成されるときに発生します。DayRender イベントのイベントハンドラにコードを記述することで、日付セルの作成時にその内容と書式を制御できます。

イベントハンドラは、イベントデータが格納されている DayRenderEventArgs オブジェクトを受け取ります。表示するセルにアクセスするには、Cell プロパティを使用します。表示する日付のプロパティにアクセスするには、Day プロパティを使用します。セルの内容をカスタマイズする場合、表示する日付をユーザーが選択するときにポストバック動作を保存するように設定できます。この処理は、通常、カスタマイズした内容の一部としてページをポストするためのスクリプトを表示することによって実行します。ページをサーバーにポストバックするためのスクリプトを取得するには、SelectUrl プロパティを使用します。

DayRenderEventArgs のインスタンスの初期プロパティ値の一覧については、DayRenderEventArgs コンストラクタのトピックを参照してください。

イベント処理の詳細については、「イベントの利用」を参照してください。

Topic	Location
方法 : Calendar Web サーバーコントロールにおける日単位のカスタマイズ	ASP .NET Web アプリケーションの作成

使用例

DayRender イベントのハンドラを指定およびコード化して、表示された月の日付の背景色を黄色にする方法を次のコード例に示します。セルに System.Web.UI.LiteralControl コントロールを追加して、セルの内容をカスタマイズする方法も示します。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True"
 %>
<html>
<head>

   <script language="VB" runat="server">
   
        Sub DayRender(source As Object,
 e As DayRenderEventArgs)
            
            ' Change the background color of the days in the month
            ' to yellow.
            If Not e.Day.IsOtherMonth And
 Not e.Day.IsWeekend Then
                e.Cell.BackColor = System.Drawing.Color.Yellow
            End If 
            ' Add custom text to cell in the Calendar control.
            If e.Day.Date.Day = 18 Then
                e.Cell.Controls.Add(New LiteralControl(ChrW(60)
 & "br" & ChrW(62) & "Holiday"))
            End If 
        End Sub 'DayRender 

   </script>
 
</head>
 
<body>
 
   <form runat="server">

      <h3>DayRender Event Example</h3>
 
      <asp:Calendar id="calendar1" 
                    OnDayRender="DayRender"
                    runat="server">

         <WeekendDayStyle BackColor="gray">
         </WeekendDayStyle>

      </asp:Calendar>
                   
   </form>
          
</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>

   <script language="C#" runat="server">
   
      void DayRender(Object source, DayRenderEventArgs e) 
      {

         // Change the background color of the days in the month
         // to yellow.
         if (!e.Day.IsOtherMonth && !e.Day.IsWeekend)
            e.Cell.BackColor=System.Drawing.Color.Yellow;

         // Add custom text to cell in the Calendar control.
         if (e.Day.Date.Day == 18)
            e.Cell.Controls.Add(new LiteralControl("<br>Holiday"));

      }

   </script>
 
</head>
 
<body>
 
   <form runat="server">

      <h3>DayRender Event Example</h3>
 
      <asp:Calendar id="calendar1" 
                    OnDayRender="DayRender"
                    runat="server">

         <WeekendDayStyle BackColor="gray">
         </WeekendDayStyle>

      </asp:Calendar>
                   
   </form>
          
</body>
</html>

JScript

<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>

   <script language="JScript" runat="server">
   
      function DayRender(source : Object, e : DayRenderEventArgs)
 
      {

         // Change the background color of the days in the month
         // to yellow.
         if (!e.Day.IsOtherMonth && !e.Day.IsWeekend)
            e.Cell.BackColor=System.Drawing.Color.Yellow;

         // Add custom text to cell in the Calendar control.
         if (e.Day.Date.Day == 18)
            e.Cell.Controls.Add(new LiteralControl("<br>Holiday"));

      }

   </script>
 
</head>
 
<body>
 
   <form runat="server">

      <h3>DayRender Event Example</h3>
 
      <asp:Calendar id="calendar1" 
                    OnDayRender="DayRender"
                    runat="server">

         <WeekendDayStyle BackColor="gray">
         </WeekendDayStyle>

      </asp:Calendar>
                   
   </form>
          
</body>
</html>

.NET Framework のセキュリティ

AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。

継承階層

System.Object
System.Web.UI.WebControls.DayRenderEventArgs

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
DayRenderEventArgs メンバ
System.Web.UI.WebControls 名前空間
Calendar クラス
DayRenderEventHandler
Calendar.DayRender イベント
TableCell
CalendarDay クラス
Cell
Day
SelectUrl
その他の技術情報
イベントの利用

DayRenderEventArgs コンストラクタ (TableCell, CalendarDay)

セルとカレンダーの日付を指定して、DayRenderEventArgs クラスの新しいインスタンスを初期化します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    cell As TableCell, _
    day As CalendarDay _
)

Visual Basic (使用法)

Dim cell As TableCell
Dim day As CalendarDay

Dim instance As New DayRenderEventArgs(cell,
 day)

public DayRenderEventArgs (
    TableCell cell,
    CalendarDay day
)

C++

public:
DayRenderEventArgs (
    TableCell^ cell, 
    CalendarDay^ day
)

public DayRenderEventArgs (
    TableCell cell, 
    CalendarDay day
)

JScript

public function DayRenderEventArgs (
    cell : TableCell, 
    day : CalendarDay
)

パラメータ

cell: Calendar 内のセルを表す TableCell。

day: Calendar に表示する日付を表す CalendarDay。

解説

このコンストラクタを使用して、DayRenderEventArgs クラスの新しいインスタンスを作成し、初期化します。

DayRenderEventArgs のインスタンスがこのコンストラクタの呼び出しによって作成される場合、次の表のプロパティは指定した値に初期化されます。

プロパティ	初期値
Cell	cell パラメータの値。
Day	day パラメータの値。

メモ
このコンストラクタは、主にコントロールの開発者によって使用されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
DayRenderEventArgs クラス
DayRenderEventArgs メンバ
System.Web.UI.WebControls 名前空間
CalendarDay クラス
TableCell
Cell
Day

DayRenderEventArgs コンストラクタ (TableCell, CalendarDay, String)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定したセル、カレンダーの日付、および選択した URL を使用して、DayRenderEventArgs クラスの新しいインスタンスを初期化します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    cell As TableCell, _
    day As CalendarDay, _
    selectUrl As String _
)

Visual Basic (使用法)

Dim cell As TableCell
Dim day As CalendarDay
Dim selectUrl As String

Dim instance As New DayRenderEventArgs(cell,
 day, selectUrl)

public DayRenderEventArgs (
    TableCell cell,
    CalendarDay day,
    string selectUrl
)

C++

public:
DayRenderEventArgs (
    TableCell^ cell, 
    CalendarDay^ day, 
    String^ selectUrl
)

public DayRenderEventArgs (
    TableCell cell, 
    CalendarDay day, 
    String selectUrl
)

JScript

public function DayRenderEventArgs (
    cell : TableCell, 
    day : CalendarDay, 
    selectUrl : String
)

パラメータ

cell: Calendar 内のセルを表す TableCell。

day: Calendar に表示する日付を表す CalendarDay。

selectUrl: 表示する日付をユーザーが選択するときに、サーバーにページをポストバックするためのスクリプト。

解説

このコンストラクタを使用して、DayRenderEventArgs クラスの新しいインスタンスを作成し、初期化します。

DayRenderEventArgs のインスタンスがこのコンストラクタの呼び出しによって作成される場合、次の表のプロパティは指定した値に初期化されます。

プロパティ	初期値
Cell	cell パラメータの値。
Day	day パラメータの値。
SelectUrl	selectUrl パラメータの値。

メモ
このコンストラクタは、主にコントロールの開発者によって使用されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DayRenderEventArgs クラス
DayRenderEventArgs メンバ
System.Web.UI.WebControls 名前空間
CalendarDay クラス
TableCell
Cell
Day
SelectUrl

DayRenderEventArgs コンストラクタ

DayRenderEventArgs クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
DayRenderEventArgs (TableCell, CalendarDay)	セルとカレンダーの日付を指定して、DayRenderEventArgs クラスの新しいインスタンスを初期化します。
DayRenderEventArgs (TableCell, CalendarDay, String)	指定したセル、カレンダーの日付、および選択した URL を使用して、DayRenderEventArgs クラスの新しいインスタンスを初期化します。

参照

DayRenderEventArgs プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	Cell	Calendar コントロールに表示されるセルを表す TableCell オブジェクトを取得します。
	Day	Calendar コントロールに表示する日付を表す CalendarDay オブジェクトを取得します。
	SelectUrl	表示する日付をユーザーが Calendar コントロール内で選択したときに、サーバーにページをポストバックするためのスクリプトを取得します。

参照

その他の技術情報

イベントの利用

DayRenderEventArgs メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

その他の技術情報

イベントの利用

DayRenderEventArgs メンバ

Calendar コントロールの DayRender イベントのデータを提供します。このクラスは継承できません。

DayRenderEventArgs データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

	名前	説明
	DayRenderEventArgs	オーバーロードされます。 DayRenderEventArgs クラスの新しいインスタンスを初期化します。

パブリックプロパティ

	名前	説明
	Cell	Calendar コントロールに表示されるセルを表す TableCell オブジェクトを取得します。
	Day	Calendar コントロールに表示する日付を表す CalendarDay オブジェクトを取得します。
	SelectUrl	表示する日付をユーザーが Calendar コントロール内で選択したときに、サーバーにページをポストバックするためのスクリプトを取得します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)