Export (0) Print
Expand All

SelectionRange Class

Represents a date selection range in a month calendar control.

System.Object
  System.Windows.Forms.SelectionRange

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[TypeConverterAttribute(typeof(SelectionRangeConverter))]
public sealed class SelectionRange

The SelectionRange type exposes the following members.

  NameDescription
Public methodSelectionRange()Initializes a new instance of the SelectionRange class.
Public methodSelectionRange(SelectionRange)Initializes a new instance of the SelectionRange class with the specified selection range.
Public methodSelectionRange(DateTime, DateTime)Initializes a new instance of the SelectionRange class with the specified beginning and ending dates.
Top

  NameDescription
Public propertyEndGets or sets the ending date and time of the selection range.
Public propertyStartGets or sets the starting date and time of the selection range.
Top

  NameDescription
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodToStringInfrastructure. Returns a string that represents the SelectionRange. (Overrides Object.ToString().)
Top

The SelectionRange is the date or dates selected and highlighted on the MonthCalendar control. If only one date is selected, the Start and End property values will be equal. The SelectionRange can be changed by the user clicking a date while dragging the mouse pointer across the desired dates, or you can set the range in code. For example, you might want to have the user enter a date range into two TextBox controls or two DateTimePicker controls and set the SelectionRange based on those dates.

The following example sets the SelectionRange property of a MonthCalendar control based on two dates entered into two TextBox controls when a Button is clicked. This code assumes new instances of a MonthCalendar control, two TextBox controls, and a Button have been created on a Form. You might consider adding code to validate the Text assigned to the text boxes to verify that they contain valid dates.

private void button1_Click(object sender,
                           EventArgs e)
{
   // Set the SelectionRange with start and end dates from text boxes. 
   try
   {
      monthCalendar1.SelectionRange = new SelectionRange(
        DateTime.Parse(textBox1.Text),
        DateTime.Parse(textBox2.Text));
   }
   catch(Exception ex)
   {
      MessageBox.Show(ex.Message);
   }
}

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft