Cette documentation est archivée et n’est pas conservée.

MonthCalendar.SelectionEnd, propriété

Obtient ou définit la date de fin de la plage de dates sélectionnée.

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

public DateTime SelectionEnd { get; set; }
/** @property */
public DateTime get_SelectionEnd ()

/** @property */
public void set_SelectionEnd (DateTime value)

public function get SelectionEnd () : DateTime

public function set SelectionEnd (value : DateTime)

Valeur de la propriété

DateTime indiquant la date de fin de la plage de sélection.

Type d'exceptionCondition

ArgumentOutOfRangeException

La valeur de date est inférieure à la valeur de MinDate.

- ou -

La valeur de date est supérieure à la valeur de MaxDate.

Si vous affectez à la valeur de la propriété SelectionEnd une date qui est antérieure à la valeur actuelle de la propriété SelectionStart, SelectionStart est affecté automatiquement de la valeur égale à SelectionEnd.

Si vous attribuez une date dans SelectionEnd qui a pour effet de faire dépasser par la sélection le nombre de jours spécifiés par la propriété MaxSelectionCount, la valeur de SelectionStart est ajustée ; SelectionStart est automatiquement défini de telle manière que le nombre de jours sélectionnés est égal à MaxSelectionCount.

RemarqueRemarque

MaxSelectionCount représente le nombre de jours de la sélection, pas la différence entre SelectionStart et SelectionEnd. Par exemple, si MaxSelectionCount est 7 (le nombre par défaut), SelectionStart et SelectionEnd ne peuvent pas être séparés de plus de six jours.

RemarqueRemarque

La définition de SelectionRange pour un contrôle MonthCalendar dont les styles visuels sont activés provoque la peinture incorrecte de la plage de sélections sur le contrôle.

L'exemple de code suivant illustre l'utilisation des propriétés SelectionStart et SelectionEnd. Pour exécuter cet exemple, collez le code suivant dans un formulaire contenant un contrôle MonthCalendar nommé MonthCalendar1 et appelez la méthode ShowAWeeksVacationOneMonthFromToday dans le constructeur du formulaire ou la méthode de gestion d'événements Load.

// Computes a week one month from today.
private void ShowAWeeksVacationOneMonthFromToday()
{
    System.DateTime today = this.MonthCalendar1.TodayDate;
    int vacationMonth = today.Month + 1;
    int vacationYear = today.Year;

    if (today.Month == 12)
    {
        vacationMonth = 1;
        ++vacationYear;
    }

    // Select the week using SelectionStart and SelectionEnd.
    this.MonthCalendar1.SelectionStart = 
        new System.DateTime(today.Year, vacationMonth, today.Day-1);
    this.MonthCalendar1.SelectionEnd = 
        new System.DateTime(today.Year, vacationMonth, today.Day+6);
}

// Computes a week one month from today.
private void ShowAWeeksVacationOneMonthFromToday()
{
    System.DateTime today = this.monthCalendar1.get_TodayDate();
    int vacationMonth = 1;
    if (today.get_Month() < 12) {
        vacationMonth = today.get_Month() + 1;
    }
    // Select the week using SelectionStart and SelectionEnd.
    this.monthCalendar1.set_SelectionStart(
        new System.DateTime(today.get_Year(),
        vacationMonth, today.get_Day() - 1));
    this.monthCalendar1.set_SelectionEnd(
        new System.DateTime(today.get_Year(),
        vacationMonth, today.get_Day() + 6));
} //ShowAWeeksVacationOneMonthFromToday

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

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0
Afficher: