Calendar.SelectedDates プロパティ

定義

DateTime コントロールで選択されている日付を表す Calendar オブジェクトのコレクションを取得します。Gets a collection of DateTime objects that represent the selected dates on the Calendar control.

public:
 property System::Web::UI::WebControls::SelectedDatesCollection ^ SelectedDates { System::Web::UI::WebControls::SelectedDatesCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.SelectedDatesCollection SelectedDates { get; }
member this.SelectedDates : System.Web.UI.WebControls.SelectedDatesCollection
Public ReadOnly Property SelectedDates As SelectedDatesCollection

プロパティ値

SelectedDatesCollection で選択されている日付を表す DateTime オブジェクトのコレクションを格納している CalendarA SelectedDatesCollection that contains a collection of DateTime objects representing the selected dates on the Calendar. 既定値は空の SelectedDatesCollection です。The default value is an empty SelectedDatesCollection.

属性

次のコード例は、 SelectedDatesコレクションを使用して、 Calendarコントロールで選択されている日付を確認する方法を示しています。The following code example demonstrates how to use the SelectedDates collection to determine the selected dates on the Calendar control.

<%@ 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>Calendar Example</title>
<script language="C#" runat="server">

      void Selection_Change(Object sender, EventArgs e) 
      {
         Label1.Text = "The selected date(s):" + "<br />";
         for (int i = 0; i <= Calendar1.SelectedDates.Count - 1; i++)
         {
            Label1.Text += Calendar1.SelectedDates[i].ToShortDateString() + "<br />";
         } 
      }

   </script>

</head>     
<body>

   <form id="form1" runat="server">

      <h3>Calendar Example</h3>

      Select date(s) on the Calendar control.<br /><br />

      <asp:Calendar ID="Calendar1" runat="server"  
           SelectionMode="DayWeekMonth" 
           ShowGridLines="True" 
           OnSelectionChanged="Selection_Change">

         <SelectedDayStyle BackColor="Yellow"
                           ForeColor="Red">
         </SelectedDayStyle>

      </asp:Calendar>  

      <hr /><br />

      <asp:Label id="Label1" runat="server" />

   </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>Calendar Example</title>
<script language="VB" runat="server">
        Sub Selection_Change(sender As Object, e As EventArgs)
            Label1.Text = "The selected date(s):" & ChrW(60) & "br" & ChrW(62)
            Dim i As Integer
            For i = 0 To Calendar1.SelectedDates.Count - 1
                Label1.Text &= Calendar1.SelectedDates(i).ToShortDateString() & ChrW(60) & "br" & ChrW(62)
            Next i
        End Sub 'Selection_Change 
   </script>
</head>     
<body>

   <form id="form1" runat="server">

      <h3>Calendar Example</h3>

      Select date(s) on the Calendar control.<br /><br />

      <asp:Calendar ID="Calendar1" runat="server"  
           SelectionMode="DayWeekMonth" 
           ShowGridLines="True" 
           OnSelectionChanged="Selection_Change">

         <SelectedDayStyle BackColor="Yellow"
                           ForeColor="Red">
         </SelectedDayStyle>

      </asp:Calendar>  

      <hr /><br />

      <asp:Label id="Label1" runat="server" />

   </form>
</body>
</html>

注釈

コントロールで現在選択されている日付を確認するには、 SelectedDatesコレクションを使用します。 CalendarUse the SelectedDates collection to determine the currently selected dates on the Calendar control.

SelectedDate プロパティSelectedDatesとコレクションは密接に関連しています。The SelectedDate property and the SelectedDates collection are closely related. CalendarSelectionMode.Day SelectedDate SelectedDates[0]プロパティがに設定されている場合、1つの日付選択のみを許可し、同じ値をSelectedDates.Count持ち、1と等しいモード。 SelectionModeWhen the SelectionMode property is set to CalendarSelectionMode.Day, a mode that allows only a single date selection, SelectedDate and SelectedDates[0] have the same value and SelectedDates.Count equals 1. SelectedDates[0] SelectedDateプロパティがまたはCalendarSelectionMode.DayWeek CalendarSelectionMode.DayWeekMonthに設定されている場合、複数の日付の選択を許可し、同じ値を持つモード。 SelectionModeWhen the SelectionMode property is set to CalendarSelectionMode.DayWeek or CalendarSelectionMode.DayWeekMonth, modes that allows multiple date selections, SelectedDate and SelectedDates[0] have the same value.

プロパティSelectedDatesは、オブジェクトのSystem.DateTimeコレクションを格納します。The SelectedDates property stores a collection of System.DateTime objects.

ユーザーがCalendarコントロールSelectionChangedの週または月を選択すると、イベントが発生します。When the user selects a week or month on the Calendar control, the SelectionChanged event is raised. 選択した日付がSelectedDatesコレクションに追加され、以前の内容が置き換えられます。The selected dates are added to the SelectedDates collection, replacing the previous contents. 日付の範囲は、日付の昇順で並べ替えられます。The range of dates are sorted in ascending order by date. SelectedDatesコレクションの最初の日付を含むように、 SelectedDateプロパティも更新されます。The SelectedDate property is also updated to contain the first date in the SelectedDates collection.

また、 SelectedDatesコレクションを使用して、 Calendarコントロールの日付をプログラムで選択することもできます。You can also use the SelectedDates collection to programmatically select dates on the Calendar control. Add SelectedDates 、、、およびSelectRangeの各メソッドを使用して、コレクション内の選択した日付をプログラムで操作します。 Clear RemoveUse the Add, Remove, Clear, and SelectRange methods to programmatically manipulate the selected dates in the SelectedDates collection.

注意

イベントが発生する前SelectedDatesに、プロパティとコレクションの両方が更新されます。SelectedDate SelectionChangedBoth the SelectedDate property and the SelectedDates collection are updated before the SelectionChanged event is raised. OnSelectionChangedイベントハンドラーを使用して、手動でSelectedDatesコレクションを設定することにより、日付の選択をオーバーライドできます。You can override the date selection by using the OnSelectionChanged event handler to manually set the SelectedDates collection. このSelectionChangedコレクションがプログラムによって設定されている場合、イベントは発生しません。The SelectionChanged event is not raised when this collection is programmatically set.

適用対象

こちらもご覧ください