Dune5 DateTime Picker Web Control V1.2 Documentation Contents

DateTimePicker Overview

Notes

The DateTimePicker is a web control that allows the user to select a single date, datetime or time value (or none at all) from a series of drop-down lists. VIEW DEMO AT http://www.datetimepicker.net/

For a list of all DateTimePicker members, see DateTimePicker Members.

Principle Class Members

Value property - Get and set the underlying System.DateTime value of the control.

DisplayFormat property - Get and set the date and\or time format used.

AllowNullValue property - Set this property to TRUE if you need to allow the user to be able to not select a value at all ( for "optional" DateTime items ).

ValueChanged event - Occurs when the Value of the control changes.

For a list of all DateTimePicker members, see DateTimePicker Members

Features and Benefits

Simplicity of development. 99% of the time all the developer needs to do is set the DisplayFormat property, and then use System.DateTime Value property on Postback.

Bullet-proof simplicity of use for users.

Allows "null" values to be submitted if required (AllowNullValue property).

All languages / locales are supported for month names, and standard date and time formats. (Culture property)

All browsers are supported.

Client side validation of invalid dates for Internet Explorer 5 and up.

Much less UI space needed than the System.Web.UI.WebControls.Calendar web control, as well as no server round-trips to navigate to the date of choice.

100% managed C# code.

Class Hierarchy

System.Object
   System.Web.UI.Control
      System.Web.UI.WebControls.WebControl
         Dune5.DateTimeUI.DateTimePicker

Syntax

[Visual Basic]
Public Class DateTimePicker
   Inherits WebControl
   Implements IPostBackDataHandler

[C#]
public class WebControl : DateTimePicker, IPostBackDataHandler

[C++]
public __gc class WebControl : public DateTimePicker,
   IPostBackDataHandler

[JScript]
public class WebControl extends DateTimePicker implements
   IPostBackDataHandler

Other Information

Namespace: Dune5.DateTimeUI

Server Platforms: IIS5 - Windows 2000, Windows XP Professional. IIS6 - Windows .NET Server family

Assembly: Dune5.DateTimeUI.DateTimePicker (in Dune5.DateTimeUI.dll)

Tested On

Server Platforms: Windows 2000, Windows XP Professional, Windows .NET Server RC 2

.NET Framework Versions: V1.0.3328, V1.0.3705.0, V1.0.3705.288

Browsers: Microsoft Internet Explorer Versions (6.0, 5.5, 5.0), Netscape Communicator 4.08, Netscape Navigator 3.03, Opera 4.02, Opera 7