DateTimePicker.Value Property

Gets or sets the date/time value assigned to the control.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

[BindableAttribute(true)] 
public DateTime Value { get; set; }
/** @property */
public DateTime get_Value ()

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

public function get Value () : DateTime

public function set Value (value : DateTime)

Property Value

The DateTime value assign to the control.

If the Value property has not been changed in code or by the user, it is set to the current date and time (DateTime.Now).

The following code example demonstrates how use the Value property to retrieve the current date value. First, the example displays the Value property. The example then increments the Value property by one day and displays the property value again.

public MyClass()
{
   // Create a new DateTimePicker
   DateTimePicker dateTimePicker1 = new DateTimePicker();
   Controls.AddRange(new Control[] {dateTimePicker1});
   MessageBox.Show(dateTimePicker1.Value.ToString());

   dateTimePicker1.Value = DateTime.Now.AddDays(1);
   MessageBox.Show(dateTimePicker1.Value.ToString());
} 

public MyClass()
{
    // Create a new DateTimePicker
    DateTimePicker dateTimePicker1 = new DateTimePicker();
    get_Controls().AddRange(new Control[] { dateTimePicker1 });
    MessageBox.Show(dateTimePicker1.get_Value().ToString());
    dateTimePicker1.set_Value(DateTime.get_Now().AddDays(1));
    MessageBox.Show(dateTimePicker1.get_Value().ToString());
} //MyClass

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0
Show: