DatePicker.SelectedDate Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

Ruft das aktuell in der Datumsauswahl ausgewählte Datum ab oder legt es fest , oder NULL, wenn kein Datum ausgewählt ist.

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)

Eigenschaftswert

IReference<DateTime>

Nullable<DateTimeOffset>

Das datum, das derzeit in der Auswahl ausgewählt ist, oder NULL , wenn kein Datum ausgewählt ist.

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1809 (eingeführt in 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v7.0)

Beispiele

In diesem Beispiel wird das Festlegen der SelectedDate -Eigenschaft im Code veranschaulicht.

<DatePicker x:Name="myDatePicker"/>

public MainPage()
{
    this.InitializeComponent();
    myDatePicker.SelectedDate = new DateTimeOffset(new DateTime(1950, 1, 1));
}

Hinweise

Das Datumsauswahl-Steuerelement verfügt sowohl über DateSelectedDate- als auch über Eigenschaften. Der Unterschied zwischen diesen besteht darin, dass Date keine NULL-Werte zulässt, während SelectedDate auf NULL festgelegt werden kann.

Der Wert von SelectedDate wird verwendet, um die Datumsauswahl aufzufüllen, und lautet standardmäßig null. Wenn SelectedDate den Wert null aufweist, wird die Date-Eigenschaft auf 12/31/1600 festgelegt. Andernfalls wird der Date-Wert mit dem SelectedDate-Wert synchronisiert. Wenn SelectedDate den Wert null aufweist, ist die Auswahl „nicht festgelegt“ und zeigt die Feldnamen anstelle eines Datums an.

Um den SelectedDate Wert in Ihrer App zu verwenden, verwenden Sie in der Regel eine Datenbindung an die SelectedDate -Eigenschaft oder behandeln das SelectedDateChanged-Ereignis .

Die SelectedDate Eigenschaft kann nicht als XAML-Attributzeichenfolge festgelegt werden, da der Windows-Runtime XAML-Parsers keine Konvertierungslogik zum Konvertieren von Zeichenfolgen in Datumsangaben als DateTime / DateTimeOffset-Objekte aufweist. Hier finden Sie einige Vorschläge, wie diese Objekte im Code definiert und auf ein anderes als das aktuelle Datum festgelegt werden können.

• DateTime: Instanziieren Sie ein Windows.Globalization.Calendar-Objekt (es wird mit dem aktuellen Datum initialisiert). Legen Sie Eigenschaften wie Tag oder Jahr fest, oder rufen Sie Methoden wie AddMonths auf, um das Datum anzupassen. Rufen Sie dann Calendar.GetDateTime auf, und verwenden Sie die zurückgegebene DateTime , um Date festzulegen.
• DateTimeOffset: Rufen Sie den Konstruktor auf. Verwenden Sie für das innere System.DateTime die Konstruktorsignatur. Oder erstellen Sie ein Standardmäßiges DateTimeOffset (es wird mit dem aktuellen Datum initialisiert), und rufen Sie Methoden wie AddMonths auf.

Eine weitere mögliche Methode besteht darin, ein Datum zu definieren, das als Datenobjekt oder im Datenkontext verfügbar ist, und dann Date als XAML-Attribut festzulegen, das auf eine {Binding}-Markuperweiterung verweist, die auf das Datum als Daten zugreifen kann.

Weitere Informationen

• SelectedDateChanged
• DatePickerSelectedValueChangedEventArgs
• Datumsauswahl