DatePicker.SelectedDate Propriedade

Definição

Namespace:

Microsoft.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.

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