Calendar.SelectedDates Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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; }
[<System.ComponentModel.Browsable(false)>]
member this.SelectedDates : System.Web.UI.WebControls.SelectedDatesCollection
Public ReadOnly Property SelectedDates As SelectedDatesCollection
Nilai Properti
SelectedDatesCollection yang berisi kumpulan DateTime objek yang mewakili tanggal yang dipilih pada Calendar. Nilai defaultnya adalah kosong SelectedDatesCollection.
- Atribut
Contoh
Contoh kode berikut menunjukkan cara menggunakan SelectedDates koleksi untuk menentukan tanggal yang dipilih pada Calendar kontrol.
<%@ 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>
Keterangan
SelectedDates Gunakan koleksi untuk menentukan tanggal yang saat ini dipilih pada Calendar kontrol.
Properti SelectedDate dan SelectedDates koleksi terkait erat.
SelectionMode Saat properti diatur ke CalendarSelectionMode.Day
, mode yang hanya memungkinkan satu pilihan tanggal, SelectedDate dan SelectedDates[0]
memiliki nilai yang sama dan SelectedDates.Count
sama dengan 1.
SelectionMode Saat properti diatur ke CalendarSelectionMode.DayWeek
atau CalendarSelectionMode.DayWeekMonth
, mode yang memungkinkan beberapa pilihan tanggal, SelectedDate dan SelectedDates[0]
memiliki nilai yang sama.
Properti SelectedDates menyimpan kumpulan System.DateTime objek.
Saat pengguna memilih seminggu atau bulan pada Calendar kontrol, SelectionChanged peristiwa akan dinaikkan. Tanggal yang dipilih ditambahkan ke SelectedDates koleksi, menggantikan konten sebelumnya. Rentang tanggal diurutkan dalam urutan naik menurut tanggal. Properti SelectedDate juga diperbarui untuk berisi tanggal pertama dalam SelectedDates koleksi.
Anda juga dapat menggunakan SelectedDates koleksi untuk memilih tanggal secara terprogram pada Calendar kontrol. AddGunakan metode , Remove, Clear, dan SelectRange untuk memanipulasi tanggal yang dipilih secara terprogram dalam SelectedDates koleksi.
Catatan
SelectedDate Properti dan koleksi diperbarui SelectedDates sebelum SelectionChanged peristiwa dinaikkan. Anda dapat mengganti pilihan tanggal dengan menggunakan penanganan OnSelectionChanged aktivitas untuk mengatur SelectedDates koleksi secara manual. Peristiwa SelectionChanged tidak dinaikkan ketika koleksi ini diatur secara terprogram.