آموزش کنترل تقویم / Calendar control در ASP.NET

کنترل تقویم / Calendar control در ASP.NET

کنترل Calendar در واقع یک کنترل وب بسیار غنی از لحاظ قابلیت می باشد. کنترل مزبور برای نمایش یک تقویم بر روی صفحه بکار می رود. این تقویم، تاریخ ماه جاری را در قالب 6 هفته برای کاربر به نمایش می گذارد. می توان بین روزها و ماه ها حرکت کرده و تاریخ مورد نظر خود را انتخاب یا مشاهده کرد. تاریخ نمایش داده شده، در واقع با تاریخ جاری سرویس دهنده (server) مطابق خواهد بود.

کنترل تقویم مبتنی بر شی DateTime در ASP.Netساخته شده و طیف گسترده ای از تاریخ را پشتیبانی می کند.

قابلیت های گوناگونی که این کنترل در اختیار شما قرار می دهد به ترتیب زیر می باشد.

• نمایش ماه
• امکان انتخاب روز، هفته و یا یک ماه
• انتخاب طیف وسیعی از روزها
• حرکت از یک ماه به ماه دیگر

کنترل نمایش روزها به صورت programmatically (به صورت برنامه ای)

نحوه ی نگارش (syntax) کلی کنترل Calender به شرح زیر می باشد.

‎‎< asp:Calender ID="Calendar1" runat="server" >‎
‎< /asp:Calender >
                        

خواص و رخدادهای کنترل Calender

کنترل Calendar دارای سه رویداد است که زیر فهرست شده.

کار با کنترل Calendar

قرار دادن یک کنترل Calender که فقط دارای اجزای اصلی بوده و هیچ code-behind ای نداشته باشد، صرفا یک تقویم ساده در اختیار سایت قرار می دهد که تنها روز، ماه و سال را نشان می دهد و همچنین امکان حرکت بین ماه ها را فراهم می کند.

کنترل Calendar به کاربر اجازه می دهد روز، هفته و ماه را مطابق میل انتخاب کند. این کار با استفاده از خاصیت SelectionMode امکان پذیر می باشد. خاصیت مذکور دارای مقادیر زیر می باشد.

دستور نگارش (syntax)

< asp:Calender ID="Calendar1" runat="server" ‎SelectionMode="DayWeekMonth" >
‎< /asp:Calender >‎
                        

هنگامی که خاصیت selection mode روی مقدار DayWeekMonth تنظیم می شود، ستونی با علامت > ظاهر می شود که امکان انتخاب ماه را فراهم می کند، همچنین علامت >> در سمت چپ اسم روز پدیدار می شود که اجازه ی انتخاب ماه را به کاربر می دهد.

مثال

مثال زیر نحوه ی انتخاب روز و نشان دادن آن در label را نمایش می دهد.

content file code

                            
< %@ Page Language="C#" AutoEventWireup="true" CodeBehind="Calendars.aspx.cs" Inherits="Asp_Net_Calendars.Calendars" % >
 
< !DOCTYPE html >
 
< html xmlns="http://www.w3.org/1999/xhtml" >
 < head runat="server" >
      < title >
         Untitled Page
      < /title >
   < /head >
   < body >
      < form id="form1" runat="server" >
         < div >
            < h3 > Your Birthday:< /h3 >
            < asp:Calendar ID="Calendar1" runat="server"  SelectionMode="DayWeekMonth" onselectionchanged="Calendar1_SelectionChanged" >
            < /asp:Calendar >
         < /div >
         < p >Todays date is:
            < asp:Label ID="lblday" runat="server" >< /asp:Label >
         < /p >
         < p >Your Birday is:
            < asp:Label ID="lblbday" runat="server" >< /asp:Label >
         < /p > 
      < /form >
   < /body >
< /html >
                        

مدیریت کننده ی رخداد (event handler) SelectionChanged

protected void Calendar1_SelectionChanged(object sender, ‎EventArgs e)‎

        ‎{‎

        ‎   lblday.Text = Calendar1.TodaysDate.ToShortDateString();‎

        ‎   lblbday.Text = Calendar1.SelectedDate.ToShortDateString();‎

        ‎}
                        

پس از اجرای فایل، خروجی زیر را مشاهده خواهید کرد.