DatePicker.SelectedDate Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define a data selecionada no momento no seletor de datas ou nula se nenhuma data for selecionada.

public:
 property IReference<DateTime> ^ SelectedDate { IReference<DateTime> ^ get(); void set(IReference<DateTime> ^ value); };

IReference<DateTime> SelectedDate();

void SelectedDate(IReference<DateTime> value);

public System.Nullable<System.DateTimeOffset> SelectedDate { get; set; }

var iReference = datePicker.selectedDate;
datePicker.selectedDate = iReference;

Public Property SelectedDate As Nullable(Of DateTimeOffset)

Valor da propriedade

IReference<DateTime>

Nullable<DateTimeOffset>

A data selecionada no momento no seletor ou nula se nenhuma data for selecionada.

Requisitos do Windows

Família de dispositivos	Windows 10, version 1809 (introduzida na 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v7.0)

Exemplos

Este exemplo demonstra a configuração da SelectedDate propriedade no código.

<DatePicker x:Name="myDatePicker"/>

public MainPage()
{
    this.InitializeComponent();
    myDatePicker.SelectedDate = new DateTimeOffset(new DateTime(1950, 1, 1));
}

Comentários

O controle seletor de data tem data e SelectedDate propriedades. A diferença entre elas é que Date não permite valores nulos e SelectedDate os permite.

O valor de SelectedDate é usado para preencher o seletor de data e, por padrão, é null. Se SelectedDate for null, a propriedade Date será definida como 12/31/1600. Caso contrário, o valor de Date será sincronizado com o valor de SelectedDate. Quando SelectedDate for null, o seletor terá sua definição removida e mostrará os nomes dos campos em vez de uma data.

Para usar o SelectedDate valor em seu aplicativo, normalmente você usa uma associação de dados para a SelectedDate propriedade ou manipula o evento SelectedDateChanged .

A SelectedDate propriedade não pode ser definida como uma cadeia de caracteres de atributo XAML, pois o analisador XAML Windows Runtime não tem uma lógica de conversão para converter cadeias de caracteres em datas como objetos DateTime / DateTimeOffset. Estas são algumas sugestões sobre como definir esses objetos no código e defini-los para uma data diferente da data atual.

• DateTime: instancie um objeto Windows.Globalization.Calendar (ele é inicializado para a data atual). Defina propriedades como Dia ou Ano ou métodos de chamada, como AddMonths, para ajustar a data. Em seguida, chame Calendar.GetDateTime e use o DateTime retornado para definir Date.
• DateTimeOffset: chame o construtor. Para o System.DateTime interno, use a assinatura do construtor. Ou crie um DateTimeOffset padrão (ele é inicializado para a data atual) e chame métodos como AddMonths.

Outra técnica possível é definir uma data disponível como um objeto de dados ou no contexto de dados e, em seguida, definir Date como um atributo XAML que referencia uma extensão de marcação {Binding} que pode acessar a data como dados.

Confira também

• SelectedDateChanged
• DatePickerSelectedValueChangedEventArgs
• Seletor de data