DatePicker.SelectedDate Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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.