DatePicker.SelectedDate Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Obtient ou définit la date actuellement sélectionnée dans le sélecteur de dates, ou null si aucune date n’est sélectionnée.

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)

Valeur de propriété

IReference<DateTime>

Nullable<DateTimeOffset>

Date actuellement sélectionnée dans le sélecteur, ou null si aucune date n’est sélectionnée.

Configuration requise pour Windows

Famille d’appareils	Windows 10, version 1809 (introduit dans 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v7.0)

Exemples

Cet exemple montre comment définir la propriété dans le SelectedDate code.

<DatePicker x:Name="myDatePicker"/>

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

Remarques

Le contrôle du sélecteur de dates a à la fois des propriétés Date et .SelectedDate La différence entre les deux est que Date n’est pas nullable, tandis que SelectedDate est nullable.

La valeur de SelectedDate est utilisée pour remplir le sélecteur de date et est null par défaut. Si SelectedDate est null, la propriété Date a la valeur 31/12/1600 ; sinon, la valeur de Date est synchronisée avec la valeur de SelectedDate. Quand SelectedDate est null, le sélecteur est « non défini » et montre les noms des champs au lieu d’une date.

Pour utiliser la SelectedDate valeur dans votre application, vous utilisez généralement une liaison de données à la SelectedDate propriété ou gérez l’événement SelectedDateChanged .

La SelectedDate propriété ne peut pas être définie en tant que chaîne d’attribut XAML, car l’analyseur XAML Windows Runtime n’a pas de logique de conversion pour convertir des chaînes en dates en tant qu’objets DateTime / DateTimeOffset. Voici quelques suggestions quant à la façon dont ces objets peuvent être définis dans le code, avec une date autre que la date actuelle.

• DateTime : instanciez un objet Windows.Globalization.Calendar (il est initialisé avec la date du jour). Définissez des propriétés telles que Day ou Year, ou appelez des méthodes telles que AddMonths pour ajuster la date. Ensuite, appelez Calendar.GetDateTime et utilisez le DateTime retourné pour définir Date.
• DateTimeOffset : appelez le constructeur. Pour le System.DateTime interne, utilisez la signature du constructeur. Ou construisez une valeur DateTimeOffset par défaut (elle est initialisée à la date actuelle) et appelez des méthodes telles que AddMonths.

Une autre technique possible consiste à définir une date disponible en tant qu’objet de données ou dans le contexte de données, puis à définir Date en tant qu’attribut XAML qui fait référence à une extension de balisage {Binding} qui peut accéder à la date en tant que données.

Voir aussi

• SelectedDateChanged
• DatePickerSelectedValueChangedEventArgs
• Sélecteur de dates