DatePicker.SelectedDate 属性

定义

命名空间:

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

示例

此示例演示如何在代码中设置 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 属性设置为 1600/12/31；否则，Date 值与 SelectedDate 值同步。 当 SelectedDate 是 null时，不设置选取器，它显示字段名称而不是日期。

若要在应用中使用 SelectedDate 值，通常使用对 属性的数据绑定 SelectedDate ，或处理 SelectedDateChanged 事件。

SelectedDate属性不能设置为 XAML 属性字符串，因为Windows 运行时 XAML 分析程序没有转换逻辑，用于将字符串转换为日期作为 DateTime / DateTimeOffset 对象。 下面是一些建议的方法，可通过它们在代码中定义这些对象，并将其设置为当前日期以外的日期。

• DateTime：将 Windows.Globalization.Calendar 对象实例化（它会初始化为当前日期）。 设置 Day 或 Year 等属性，或调用 AddMonths 等方法来调整日期。 然后，调用 Calendar.GetDateTime 并使用返回的 DateTime 设置 Date。
• DateTimeOffset：调用构造函数。 对于内部 System.DateTime，请使用构造函数签名。 或者，构造默认 DateTimeOffset (它初始化为当前日期) 并调用 AddMonths 等方法。

另一种可能的方法是定义一个可用作数据对象或数据上下文中的日期，然后将 Date 设置为 XAML 属性，该属性引用一个 { Binding} 标记扩展 ，该扩展可以访问日期作为数据。

另请参阅

• SelectedDateChanged
• DatePickerSelectedValueChangedEventArgs
• 日期选取器