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