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 속성이 12/31/1600으로 설정되며, 그렇지 않을 경우 Date 값이 SelectedDate 값과 동기화됩니다. SelectedDate가 null이면 선택기가 '설정 해제'되며 날짜 대신 필드 이름을 표시합니다.

앱에서 SelectedDate 값을 사용하려면 일반적으로 속성에 대한 데이터 바인딩을 SelectedDate 사용하거나 SelectedDateChanged 이벤트를 처리합니다.

SelectedDate Windows 런타임 XAML 파서에는 DateTimeDateTimeOffset / 개체로 문자열을 날짜로 변환하기 위한 변환 논리가 없으므로 속성을 XAML 특성 문자열로 설정할 수 없습니다. 이러한 개체를 코드에 정의하고 현재 날짜 이외의 날짜로 설정할 수 있는 몇 가지 추천 방법은 다음과 같습니다.

• DateTime: Windows.Globalization.Calendar 개체를 인스턴스화합니다(현재 날짜로 초기화됨). 날짜 또는 연도와 같은 속성 또는 AddMonths와 같은 호출 메서드를 설정하여 날짜를 조정합니다. 그런 다음 Calendar.GetDateTime 을 호출하고 반환된 DateTime 을 사용하여 날짜를 설정합니다.
• DateTimeOffset: 생성자를 호출합니다. 내부 System.DateTime의 경우 생성자 시그니처를 사용합니다. 또는 기본 DateTimeOffset (현재 날짜로 초기화됨)을 구성하고 AddMonths와 같은 메서드를 호출합니다.

또 다른 가능한 방법은 데이터 개체 또는 데이터 컨텍스트에서 사용할 수 있는 날짜를 정의한 다음 날짜에 데이터로 액세스할 수 있는 {Binding} 태그 확장을 참조하는 XAML 특성으로 Date를 설정하는 것입니다.

추가 정보

• SelectedDateChanged
• DatePickerSelectedValueChangedEventArgs
• 날짜 선택기