DatePicker.Date Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает дату, заданную в данный момент в элементе выбора даты.
public:
property DateTime Date { DateTime get(); void set(DateTime value); };
DateTime Date();
void Date(DateTime value);
public System.DateTimeOffset Date { get; set; }
var dateTime = datePicker.date;
datePicker.date = dateTime;
Public Property Date As DateTimeOffset
Значение свойства
Дата, заданная в данный момент в окне выбора.
Примеры
В этом примере показано задание свойства в коде Date
.
<DatePicker x:Name="myDatePicker"/>
public MainPage()
{
this.InitializeComponent();
myDatePicker.Date = 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
, управляющий элемент выбора будет иметь значение "не задано" и отображать имена полей вместо даты.
Чтобы использовать Date
значение в приложении, обычно используется привязка данных к свойству Date или обработка события DateChanged .
Свойство Date
нельзя задать как строку атрибута XAML, так как средство синтаксического анализа XAML среда выполнения Windows не имеет логики преобразования строк в даты в виде объектов DateTime / DateTimeOffset. Ниже приведено несколько способов определения этих объектов в коде и настройки даты, отличающейся от текущей.
- DateTime: создание экземпляра объекта Windows.Globalization.Calendar (он инициализируется до текущей даты). Задайте свойства, такие как День или Год, или вызовите методы, такие как AddMonths, для настройки даты. Затем вызовите Calendar.GetDateTime и используйте возвращаемое значение DateTime , чтобы задать значение Date.
- DateTimeOffset: вызов конструктора. Для внутреннего объекта System.DateTime используйте сигнатуру конструктора. Или создайте значение по умолчанию DateTimeOffset (оно инициализируется текущей датой) и вызовите методы, такие как AddMonths.
Другой возможный способ — определить дату, доступную в виде объекта данных или в контексте данных, а затем задать Date
в качестве атрибута XAML, который ссылается на расширение разметки {Binding} , которое может обращаться к дате как к данным.