Calendar.SelectedDate Propriedade

  • Referência

Definição

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

Obtém ou define a data selecionada.

public:
 property DateTime SelectedDate { DateTime get(); void set(DateTime value); };
[System.ComponentModel.Bindable(true)]
public DateTime SelectedDate { get; set; }
[System.ComponentModel.Bindable(true, System.ComponentModel.BindingDirection.TwoWay)]
public DateTime SelectedDate { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.SelectedDate : DateTime with get, set
[<System.ComponentModel.Bindable(true, System.ComponentModel.BindingDirection.TwoWay)>]
member this.SelectedDate : DateTime with get, set
Public Property SelectedDate As DateTime

Valor da propriedade

DateTime

Um DateTime que representa a data selecionada. O valor padrão é DateTime.MinValue.

Atributos
BindableAttribute

Exemplos

O exemplo de código a seguir demonstra como usar a SelectedDate propriedade para determinar a data selecionada 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 is " + Calendar1.SelectedDate.ToShortDateString();
      }

   </script>

</head>     
<body>

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

      <h3>Calendar Example</h3>

      Select a date on the Calendar control.<br /><br />

      <asp:Calendar ID="Calendar1" runat="server"  
           SelectionMode="Day" 
           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 is " & Calendar1.SelectedDate.ToShortDateString()
        End Sub 'Selection_Change 
   </script>

</head>     
<body>

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

      <h3>Calendar Example</h3>

      Select a date on the Calendar control.<br /><br />

      <asp:Calendar ID="Calendar1" runat="server"  
           SelectionMode="Day" 
           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 SelectedDate propriedade para determinar a data selecionada no Calendar controle.

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

A SelectedDate propriedade é definida usando um System.DateTime objeto .

Quando o usuário seleciona uma data no Calendar controle, o SelectionChanged evento é gerado. A SelectedDate propriedade é atualizada para a data selecionada. A SelectedDates coleção também é atualizada para conter apenas esta data.

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 SelectedDate propriedade. O SelectionChanged evento não é gerado quando essa propriedade é definida programaticamente.

Aplica-se a

Confira também