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));
}

備註

日期選擇器控制項同時具有 日期 和 SelectedDate 屬性。 這兩者之間的差異是 Date 不可為 Null，而 SelectedDate 可為 Null。

的值 SelectedDate 是用來填入日期選擇器，預設為 null 。 如果 為 SelectedDatenull，則 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
• 日期選擇器