DatePicker.SelectedDate Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Ruft das datum ab, das derzeit in der Datumsauswahl ausgewählt ist, oder legt es null fest, 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 aktuell in der Auswahl ausgewählte Datum oder NULL , wenn kein Datum ausgewählt ist.

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 Datumsauswahlsteuerelement 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-Parser 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 auf das aktuelle Datum initialisiert) und Rufen Sie Methoden wie AddMonths auf.

Ein weiteres mögliches Verfahren 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