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 值同步處理。 當 為 null 時 SelectedDate ，選擇器為 'unset'，並顯示功能變數名稱而非日期。

若要在應用程式中使用 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
• 日期選擇器