DatePicker.Date 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定日期選擇器中目前設定的日期。
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 選擇器控制同時具備 DateSelectDate 屬性。 它們之間的差異在於 Date 不可為 Null,而 SelectedDate 可為 Null。
SelectedDate 的值用於填入日期選取器,預設為 null。 如果 SelectedDate是 null,則 Date 屬性設定為 12/31/1600; 否則,Date 值會與 SelectedDate 值同步。 當 SelectedDate 是 null 時,選取器處於「未設定」狀態,並顯示欄位名稱而不是日期。
要在應用程式中使用該 Date 值,通常會使用資料綁定到 Date 屬性,或處理 DateChanged 事件。
該Date屬性無法設定為 XAML 屬性字串,因為 Windows 執行階段 的 XAML 解析器沒有將字串轉換為日期作為 DateTime / DateTimeOffset 物件的轉換邏輯。 以下是一些建議的方法,可以在程式碼中定義這些物件,並將其設定為目前日期以外的日期。
- DateTime:實例化一個Windows。Globalization.Calendar物件(初始化為當前日期)。 設定屬性如 Day 或 Year,或呼叫 AddMonths 等方法來調整日期。 然後,打電話給 Calendar.GetDateTime ,並用回傳的 DateTime 來設定日期。
- DateTimeOffset:呼叫建構函式。 針對內部 System.DateTime,請使用建構函式簽章。 或者,建立一個預設 的 DateTimeOffset (初始化為當前日期),並呼叫像 AddMonths 這類方法。
另一種可能的方法是定義一個日期,該日期可作為資料物件或資料上下文中可用,然後設定 Date 為一個 XAML 屬性,參考一個可存取日期的 {Binding} 標記擴充功能 。