This documentation is archived and is not being maintained.

DateTimePicker.Text Property

Gets or sets the text associated with this control.

[Visual Basic]
Overrides Public Property Text As String
public override string Text {get; set;}
public: __property String* get_Text();
public: __property void set_Text(String*);
public override function get Text() : String;
public override function set Text(String);

Property Value

A string that represents the text associated with this control.


The string returned by this property is equivalent to the Value property with the appropriate formatting or custom formatting applied. For example, if the Value property is set to 06/01/2001 12:00:00 AM while the CustomFormat property is set to "dddd, MMMM dd, yyyy", the Text property value is "Friday, June 01, 2001".

When setting this property, the string must be convertible to an instance of the DateTime class. It is possible to define a custom format that results in a string that cannot be converted to a valid DateTime value. Because of this, the string returned from the Text property might cause an error if it is passed back to the Text property. If the string cannot be converted to a date/time value, the DateTime class throws a FormatException.


Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

DateTimePicker Class | DateTimePicker Members | System.Windows.Forms Namespace | DateTime | Value