Calendar.SelectedDate Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Um DateTime que representa a data selecionada. O valor padrão é DateTime.MinValue.
- Atributos
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.