DateTimePicker, classe

Le contrôle DateTimePicker est utilisé pour permettre à l'utilisateur de sélectionner une date et une heure, et pour afficher cette valeur au format spécifié. Vous pouvez restreindre la fourchette de dates et d'heures qu'il sera possible de sélectionner en définissant les propriétés MinDate et MaxDate.

Vous pouvez modifier l'apparence de la partie calendrier du contrôle en définissant les propriétés CalendarForeColor, CalendarFont, CalendarTitleBackColor, CalendarTitleForeColor, CalendarTrailingForeColor et CalendarMonthBackground.

La propriété Format détermine le DateTimePickerFormat du contrôle. Le Format de la date par défaut est DateTimePickerFormat.Long. Si la propriété Format a la valeur DateTimePickerFormat.Custom, vous pouvez créer votre propre style de format en définissant la propriété CustomFormat et en créant une chaîne de format personnalisée. Cette dernière peut être une combinaison de caractères de champ personnalisés et d'autres caractères littéraux. Par exemple, vous pouvez afficher la date au format "11 octobre 2001 - jeudi" en affectant la valeur "dd MMMM yyyy - dddd" à la propriété CustomFormat. Pour plus d'informations, consultez Chaînes de format de date et d'heure.

Afin d'utiliser un contrôle toupie (également appelé contrôle up-down) pour régler la valeur de date/heure, affectez à la propriété ShowUpDown la valeur true. Lors de sa sélection, le contrôle Calendar ne se déroulera pas. La date et l'heure peuvent être réglées en sélectionnant chaque élément individuellement et en utilisant les boutons haut et bas pour en modifier la valeur.

Vous pouvez envisager d'utiliser un contrôle DateTimePicker au lieu de MonthCalendar si vous avez besoin d'un format de date personnalisé (et d'une sélection limitée à une seule date, par exemple). L'utilisation de DateTimePicker permet de réduire les contraintes de validation des données dans les valeurs de date/heure.

Remarque :
Le contrôle DateTimePicker ne prend en charge que les calendriers grégoriens.

Attention :

Lorsqu'un DateTimePicker est lié aux données et que la valeur de stockage est remplacée par null, la valeur du DateTimePicker ne sera pas mise à jour et la valeur précédente sera conservée. Lorsque ce comportement n'est pas souhaité (par exemple, lorsque vous utilisez un ensemble de contrôles liés aux données pour parcourir un jeu d'enregistrements), utilisez l'événement Format de la classe Binding pour affecter au DateTimePicker une valeur reconnaissable en tant que valeur null.

L'exemple de code suivant crée une nouvelle instance d'un contrôle DateTimePicker et l'initialise. La propriété CustomFormat du contrôle est définie. En outre, la propriété ShowCheckBox est définie de sorte que le contrôle affiche CheckBox ; la propriété ShowUpDown est définie pour que le contrôle s'affiche sous la forme d'un contrôle toupie (également appelé contrôle up-down). Pour exécuter cet exemple, collez le code suivant dans un formulaire et appelez la méthode CreateMyDateTimePicker dans le constructeur ou la méthode de gestion d'événements Load de l'exemple de formulaire.

public void CreateMyDateTimePicker()
{
   // Create a new DateTimePicker control and initialize it.
   DateTimePicker dateTimePicker1 = new DateTimePicker();

   // Set the MinDate and MaxDate.
   dateTimePicker1.MinDate = new DateTime(1985, 6, 20);
   dateTimePicker1.MaxDate = DateTime.Today;

   // Set the CustomFormat string.
   dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd";
   dateTimePicker1.Format = DateTimePickerFormat.Custom;

   // Show the CheckBox and display the control as an up-down control.
   dateTimePicker1.ShowCheckBox = true;
   dateTimePicker1.ShowUpDown = true;
}

public void CreateMyDateTimePicker()
{
    // Create a new DateTimePicker control and initialize it.
    DateTimePicker dateTimePicker1 = new DateTimePicker();

    // Set the MinDate and MaxDate.
    dateTimePicker1.set_MinDate(new DateTime(1985, 6, 20));
    dateTimePicker1.set_MaxDate(DateTime.get_Today());

    // Set the CustomFormat string.
    dateTimePicker1.set_CustomFormat("MMMM dd, yyyy - dddd");
    dateTimePicker1.set_Format(DateTimePickerFormat.Custom);

    // Show the CheckBox and display the control as an up-down control.
    dateTimePicker1.set_ShowCheckBox(true);
    dateTimePicker1.set_ShowUpDown(true);
} //CreateMyDateTimePicker

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

.NET Compact Framework

Référence