DayRenderEventArgs 類別

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

提供 DayRender 控制項的 Calendar 事件資料。 此類別無法獲得繼承。

public ref class DayRenderEventArgs sealed
public sealed class DayRenderEventArgs
type DayRenderEventArgs = class
Public NotInheritable Class DayRenderEventArgs
繼承
Object
DayRenderEventArgs

範例

下列程式碼範例示範如何指定和撰寫事件的處理常式 DayRender ，使顯示月份中的天數背景色彩變成黃色。 它也會示範如何將控制項新增 System.Web.UI.LiteralControl 至儲存格，來自訂儲存格的內容。

<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>DayRender Event Example</title>
<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 id="form1" 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="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>DayRender Event Example</title>
<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 id="form1" runat="server">

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

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

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

備註

雖然控制項不支援 Calendar 資料系結，但可以修改個別日期儲存格的內容和格式設定。 Calendar在控制項顯示在網頁上之前，它會建立並組合組成控制項的元件。 建立 DayRender 控制項中的每個 Calendar 日期資料格時，就會引發事件。 您可以在事件事件處理常式 DayRender 中提供程式碼，來控制日期儲存格的內容和格式設定。

事件處理常式會 DayRenderEventArgs 接收包含事件資料的 物件。 Cell使用 屬性來存取正在呈現的資料格。 若要存取正在轉譯的日期屬性，請使用 Day 屬性。 自訂儲存格的內容時，您可能會想要在使用者選取要轉譯的日期時保留回傳行為。 這通常是透過轉譯用來張貼頁面的腳本作為自訂內容的一部分來完成。 若要擷取用來將頁面張貼回伺服器的腳本，請使用 SelectUrl 屬性。

如需 實例 DayRenderEventArgs 的初始屬性值清單，請參閱 建 DayRenderEventArgs 構函式。

如需如何處理事件的詳細資訊，請參閱 處理和引發事件。

建構函式

DayRenderEventArgs(TableCell, CalendarDay)

使用指定的儲存格及日曆日期，初始化 DayRenderEventArgs 類別的新執行個體。
DayRenderEventArgs(TableCell, CalendarDay, String)

使用指定的儲存格、日曆日期和選取 URL，初始化 DayRenderEventArgs 類別的新執行個體。

屬性

Cell

取得 TableCell 物件，表示正在 Calendar 控制項中呈現的儲存格。
Day

取得 CalendarDay 物件，表示正在 Calendar 控制項中呈現的日期。
SelectUrl

取得當 Calendar 控制項中選取了正在呈現的日期後，用來將頁面回傳至伺服器的指令碼。

方法

Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetType()

取得目前執行個體的 Type。

(繼承來源 Object)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)

適用於

另請參閱