Calendar.SelectedDates Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
Valeur de propriété
Qui SelectedDatesCollection contient une collection d’objets DateTime représentant les dates sélectionnées sur le Calendar. La valeur par défaut est un SelectedDatesCollection vide.
- Attributs
Exemples
L’exemple de code suivant montre comment utiliser la SelectedDates collection pour déterminer les dates sélectionnées sur le Calendar contrôle.
<%@ 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>
Remarques
Utilisez la SelectedDates collection pour déterminer les dates actuellement sélectionnées sur le Calendar contrôle.
La SelectedDate propriété et la SelectedDates collection sont étroitement liées. Lorsque la SelectionMode propriété est définie CalendarSelectionMode.Daysur , mode qui autorise uniquement une sélection de date unique et SelectedDateSelectedDates[0] qui a la même valeur et SelectedDates.Count est égal à 1. Lorsque la SelectionMode propriété est définie CalendarSelectionMode.DayWeek sur ou CalendarSelectionMode.DayWeekMonth, les modes qui autorisent plusieurs sélections de SelectedDate dates et SelectedDates[0] ont la même valeur.
La SelectedDates propriété stocke une collection d’objets System.DateTime .
Lorsque l’utilisateur sélectionne une semaine ou un mois sur le Calendar contrôle, l’événement SelectionChanged est déclenché. Les dates sélectionnées sont ajoutées à la SelectedDates collection, en remplaçant le contenu précédent. La plage de dates est triée par ordre croissant par date. La SelectedDate propriété est également mise à jour pour contenir la première date de la SelectedDates collection.
Vous pouvez également utiliser la SelectedDates collection pour sélectionner par programmation des dates sur le Calendar contrôle. Utilisez les méthodes , Removeet SelectRangeClearutilisez les Addméthodes pour manipuler par programmation les dates sélectionnées dans la SelectedDates collection.
Note
La propriété et la SelectedDateSelectedDates collection sont mises à jour avant le levée de l’événement SelectionChanged . Vous pouvez remplacer la sélection de date à l’aide du OnSelectionChanged gestionnaire d’événements pour définir manuellement la SelectedDates collection. L’événement SelectionChanged n’est pas déclenché lorsque cette collection est définie par programme.