DatePicker.SelectedDate Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает дату, выбранную в данный момент в элементе выбора даты, или значение 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)
Значение свойства
Дата, выбранная в данный момент в окне выбора, или значение 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} , которое может обращаться к дате как к данным.