DatePicker.SelectedDate Свойство

Определение

Пространство имен:

Windows.UI.Xaml.Controls

Возвращает или задает дату, выбранную в данный момент в элементе выбора даты, или значение NULL , если дата не выбрана.

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)

Значение свойства

IReference<DateTime>

Nullable<DateTimeOffset>

Дата, выбранная в данный момент в окне выбора, или значение NULL , если дата не выбрана.

Требования к Windows

Семейство устройств	Windows 10, version 1809 (появилось в 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v7.0)

Примеры

В этом примере показано задание свойства в коде SelectedDate .

<DatePicker x:Name="myDatePicker"/>

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

Комментарии

Элемент управления "Выбор даты" имеет свойства Date и SelectedDate . Разница между ними заключается в том, что свойство Date не допускает значения NULL, тогда как свойство SelectedDate допускает значение NULL.

Значение SelectedDate используется для внесения данных в управляющий элемент выбора даты. По умолчанию установлено значение null. Если свойство SelectedDate имеет значение null, для Date задается формат 12/31/1600. В противном случае это значение Date синхронизируется со значением SelectedDate. Если свойство SelectedDate имеет значение null, управляющий элемент выбора будет иметь значение "не задано" и отображать имена полей вместо даты.

Чтобы использовать SelectedDate значение в приложении, обычно используется привязка данных к свойству SelectedDate или обработка события SelectedDateChanged .

Свойство SelectedDate нельзя задать как строку атрибута XAML, так как средство синтаксического анализа XAML среда выполнения Windows не имеет логики преобразования строк в даты в виде объектов DateTime / DateTimeOffset. Ниже приведено несколько способов определения этих объектов в коде и настройки даты, отличающейся от текущей.

• DateTime: создание экземпляра объекта Windows.Globalization.Calendar (он инициализируется до текущей даты). Задайте свойства, такие как День или Год, или вызовите методы, такие как AddMonths, для настройки даты. Затем вызовите Calendar.GetDateTime и используйте возвращаемое значение DateTime , чтобы задать значение Date.
• DateTimeOffset: вызов конструктора. Для внутреннего объекта System.DateTime используйте сигнатуру конструктора. Или создайте значение по умолчанию DateTimeOffset (оно инициализируется текущей датой) и вызовите методы, такие как AddMonths.

Другой возможный способ — определить дату, доступную в виде объекта данных или в контексте данных, а затем задать Date в качестве атрибута XAML, который ссылается на расширение разметки {Binding} , которое может обращаться к дате как к данным.

См. также раздел

• SelectedDateChanged
• DatePickerSelectedValueChangedEventArgs
• Выбор даты