Calendar.SelectedDates Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém uma coleção de objetos DateTime que representam as datas selecionadas no controle Calendar.

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

Valor da propriedade

SelectedDatesCollection

Um SelectedDatesCollection que contém uma coleção de objetos DateTime que representam as datas selecionadas no Calendar. O valor padrão é um SelectedDatesCollection vazio.

Atributos
BrowsableAttribute

Exemplos

O exemplo de código a seguir demonstra como usar a SelectedDates coleção para determinar as datas selecionadas no Calendar controle.

<%@ 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>

Comentários

Use a SelectedDates coleção para determinar as datas selecionadas no momento no Calendar controle.

A SelectedDate propriedade e a SelectedDates coleção estão intimamente relacionadas. Quando a SelectionMode propriedade é definida CalendarSelectionMode.Daycomo , um modo que permite apenas uma seleção SelectedDate de data e SelectedDates[0] tem o mesmo valor e SelectedDates.Count é igual a 1. Quando a SelectionMode propriedade é definida CalendarSelectionMode.DayWeek como ou CalendarSelectionMode.DayWeekMonth, os modos que permitem várias seleções SelectedDate de data e SelectedDates[0] têm o mesmo valor.

A SelectedDates propriedade armazena uma coleção de System.DateTime objetos .

Quando o usuário seleciona uma semana ou mês no Calendar controle, o SelectionChanged evento é gerado. As datas selecionadas são adicionadas à SelectedDates coleção, substituindo o conteúdo anterior. O intervalo de datas é classificado em ordem crescente por data. A SelectedDate propriedade também é atualizada para conter a primeira data na SelectedDates coleção.

Você também pode usar a SelectedDates coleção para selecionar programaticamente datas no Calendar controle . Use os Addmétodos , Remove, Cleare SelectRange para manipular programaticamente as datas selecionadas na SelectedDates coleção.

Observação

SelectedDate A propriedade e a SelectedDates coleção são atualizadas antes que o SelectionChanged evento seja gerado. Você pode substituir a seleção de data usando o OnSelectionChanged manipulador de eventos para definir manualmente a SelectedDates coleção. O SelectionChanged evento não é gerado quando essa coleção é definida programaticamente.

Aplica-se a

Confira também