DateTimePicker 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示一个 Windows 控件，该控件用来让用户选择日期和时间并以指定的格式显示此日期和时间。
public ref class DateTimePicker : System::Windows::Forms::Controlpublic class DateTimePicker : System.Windows.Forms.Control[System.ComponentModel.DefaultBindingProperty("Value")]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class DateTimePicker : System.Windows.Forms.Control[System.ComponentModel.DefaultBindingProperty("Value")]
public class DateTimePicker : System.Windows.Forms.Controltype DateTimePicker = class
inherit Control[<System.ComponentModel.DefaultBindingProperty("Value")>]
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type DateTimePicker = class
inherit Control[<System.ComponentModel.DefaultBindingProperty("Value")>]
type DateTimePicker = class
inherit ControlPublic Class DateTimePicker
Inherits Control- 继承
- 属性
示例
下面的代码示例创建控件的新实例 DateTimePicker 并对其进行初始化。 控件的 CustomFormat 属性已设置。 此外， ShowCheckBox 设置 属性，以便控件显示 CheckBox，设置 ShowUpDown 属性，以便控件显示为旋转按钮控件。 若要运行此示例，请将以下代码粘贴到窗体中，并在示例窗体的构造函数或Load事件处理方法中调用 CreateMyDateTimePicker 方法。
public:
void CreateMyDateTimePicker()
{
// Create a new DateTimePicker control and initialize it.
DateTimePicker^ dateTimePicker1 = gcnew DateTimePicker;
// Set the MinDate and MaxDate.
dateTimePicker1->MinDate = DateTime(1985,6,20);
dateTimePicker1->MaxDate = DateTime::Today;
// Set the CustomFormat string.
dateTimePicker1->CustomFormat = "MMMM dd, yyyy - dddd";
dateTimePicker1->Format = DateTimePickerFormat::Custom;
// Show the CheckBox and display the control as an up-down control.
dateTimePicker1->ShowCheckBox = true;
dateTimePicker1->ShowUpDown = true;
}
public void CreateMyDateTimePicker()
{
// Create a new DateTimePicker control and initialize it.
DateTimePicker dateTimePicker1 = new DateTimePicker();
// Set the MinDate and MaxDate.
dateTimePicker1.MinDate = new DateTime(1985, 6, 20);
dateTimePicker1.MaxDate = DateTime.Today;
// Set the CustomFormat string.
dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd";
dateTimePicker1.Format = DateTimePickerFormat.Custom;
// Show the CheckBox and display the control as an up-down control.
dateTimePicker1.ShowCheckBox = true;
dateTimePicker1.ShowUpDown = true;
}
Public Sub CreateMyDateTimePicker()
' Create a new DateTimePicker control and initialize it.
Dim dateTimePicker1 As New DateTimePicker()
' Set the MinDate and MaxDate.
dateTimePicker1.MinDate = New DateTime(1985, 6, 20)
dateTimePicker1.MaxDate = DateTime.Today
' Set the CustomFormat string.
dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd"
dateTimePicker1.Format = DateTimePickerFormat.Custom
' Show the CheckBox and display the control as an up-down control.
dateTimePicker1.ShowCheckBox = True
dateTimePicker1.ShowUpDown = True
End Sub
注解
控件 DateTimePicker 用于允许用户选择日期和时间，以及以指定格式显示该日期和时间。 控件 DateTimePicker 可以轻松处理日期和时间，因为它会自动处理大量数据验证。
注意
控件 DateTimePicker 仅支持公历。
当用于表示日期时， DateTimePicker 控件将按两部分显示：一个以文本表示日期的下拉列表，以及一个在单击列表旁边的向下箭头时显示的日历。 日历类似于 MonthCalendar 控件，可用于选择多个日期。 有关控件的详细信息 MonthCalendar ，请参阅 MonthCalendar 控件概述。
可以通过设置 CalendarForeColor、、、CalendarTitleForeColorCalendarTrailingForeColorCalendarFontCalendarTitleBackColor、 和 CalendarMonthBackground 属性来更改控件的日历部分的外观。
若要使用旋转按钮控件 (也称为向上向下控件) 调整日期/时间值，请将 属性设置为 ShowUpDowntrue。 选择控件时，日历不会下拉。 可以通过单独选择每个元素并使用向上和向下按钮更改值来调整日期和时间。
Value 属性包含控件设置的当前日期和时间。 可以使用 属性 Text 或 的相应成员 Value 来获取日期和时间值。 有关详细信息，请参阅如何：使用Windows 窗体 DateTimePicker 控件设置和返回日期。 可以通过设置 和 MaxDate 属性来限制可以选择的MinDate日期和时间。
这些值可以采用四种格式显示，这些格式由 Format 属性设置：Long、Short、Time 或 Custom。 默认日期 Format 为 DateTimePickerFormat.Long。
如果希望 DateTimePicker 显示为用于选取或编辑时间的控件而不是日期，请将 属性设置为 ShowUpDowntrue ，将 Format 属性设置为 Time。 有关详细信息，请参阅 如何：使用 DateTimePicker 控件显示时间。
如果 属性 Format 设置为 DateTimePickerFormat.Custom，则可以通过设置 CustomFormat 属性并生成自定义格式字符串来创建自己的格式样式。 自定义格式字符串可以是自定义字段字符和其他文本字符的组合。 例如，通过将 属性设置为 CustomFormat “MMMM dd， yyyy - d”，可以将日期显示为“2012 年 6 月 1 日 - 星期五”。 有关详细信息，请参阅如何：使用Windows 窗体 DateTimePicker 控件以自定义格式显示日期和自定义日期和时间格式字符串。
注意
DateTimePicker当 数据绑定并且支持值更改为 null时，将不会更新 的值DateTimePicker，并且将保留以前的值。 例如，在不需要此行为的情况下， (使用一组数据绑定控件分页浏览记录集) 使用 Format 类的 Binding 事件将 设置为 DateTimePicker 可识别为 null的值。
构造函数
| DateTimePicker() |
初始化 DateTimePicker 类的新实例。 |
字段
| DefaultMonthBackColor |
指定 DateTimePicker 控件月份的默认背景色。 此字段为只读。 |
| DefaultTitleBackColor |
指定 DateTimePicker 控件标题的默认背景色。 此字段为只读。 |
| DefaultTitleForeColor |
指定 DateTimePicker 控件标题的默认前景色。 此字段为只读。 |
| DefaultTrailingForeColor |
指定 DateTimePicker 控件结尾的默认前景色。 此字段为只读。 |
| MaxDateTime |
指定 DateTimePicker 控件的最大日期值。 此字段为只读。 |
| MinDateTime |
获取 DateTimePicker 控件的最小日期值。 |
属性
| AccessibilityObject |
获取分配给该控件的 AccessibleObject。 (继承自 Control) |
| AccessibleDefaultActionDescription |
获取或设置控件的默认操作说明以供具有辅助功能的客户端应用程序使用。 (继承自 Control) |
| AccessibleDescription |
获取或设置辅助功能客户端应用程序使用的控件说明。 (继承自 Control) |
| AccessibleName |
获取或设置辅助功能客户端应用程序所使用的控件名称。 (继承自 Control) |
| AccessibleRole |
获取或设置控件的辅助性角色。 (继承自 Control) |
| AllowDrop |
获取或设置一个值，该值指示控件是否可以接受用户拖放到它上面的数据。 (继承自 Control) |
| Anchor |
获取或设置控件绑定到的容器的边缘并确定控件如何随其父级一起调整大小。 (继承自 Control) |
| AutoScrollOffset |
获取或设置一个值，该值指示在 ScrollControlIntoView(Control) 中将控件滚动到何处。 (继承自 Control) |
| AutoSize |
此属性与此类无关。 (继承自 Control) |
| BackColor |
获取或设置一个值，该值指示 DateTimePicker 控件的背景色。 |
| BackgroundImage |
获取或设置控件的背景图像。 |
| BackgroundImageLayout |
获取或设置 DateTimePicker 控件的背景图像的布局。 |
| BackgroundImageLayout |
获取或设置在 ImageLayout 枚举中定义的背景图像布局。 (继承自 Control) |
| BindingContext |
获取或设置控件的 BindingContext。 (继承自 Control) |
| Bottom |
获取控件下边缘与其容器的工作区上边缘之间的距离（以像素为单位）。 (继承自 Control) |
| Bounds |
获取或设置控件（包括其非工作区元素）相对于其父控件的大小和位置（以像素为单位）。 (继承自 Control) |
| CalendarFont |
获取或设置应用于日历的字体样式。 |
| CalendarForeColor |
获取或设置日历的前景色。 |
| CalendarMonthBackground |
获取或设置日历月的背景色。 |
| CalendarTitleBackColor |
获取或设置日历标题的背景色。 |
| CalendarTitleForeColor |
获取或设置日历标题的前景色。 |
| CalendarTrailingForeColor |
获取或设置日历结尾日期的前景色。 |
| CanEnableIme |
获取一个用以指示是否可以将 ImeMode 属性设置为活动值的值，以启用 IME 支持。 (继承自 Control) |
| CanFocus |
获取一个值，该值指示控件是否可以接收焦点。 (继承自 Control) |
| CanRaiseEvents |
确定是否可以在控件上引发事件。 (继承自 Control) |
| CanSelect |
获取一个值，该值指示是否可以选中控件。 (继承自 Control) |
| Capture |
获取或设置一个值，该值指示控件是否已捕获鼠标。 (继承自 Control) |
| CausesValidation |
获取或设置一个值，该值指示控件是否会引起在任何需要在接收焦点时执行验证的控件上执行验证。 (继承自 Control) |
| Checked |
获取或设置一个值，该值指示是否已用有效日期/时间值设置了 Value 属性且显示的值可以更新。 |
| ClientRectangle |
获取表示控件的工作区的矩形。 (继承自 Control) |
| ClientSize |
获取或设置控件的工作区的高度和宽度。 (继承自 Control) |
| CompanyName |
获取包含控件的应用程序的公司名称或创建者。 (继承自 Control) |
| Container |
获取包含 IContainer 的 Component。 (继承自 Component) |
| ContainsFocus |
获取一个值，该值指示控件或它的一个子控件当前是否有输入焦点。 (继承自 Control) |
| ContextMenu |
获取或设置与控件关联的快捷菜单。 (继承自 Control) |
| ContextMenuStrip |
获取或设置与此控件关联的 ContextMenuStrip。 (继承自 Control) |
| Controls |
获取包含在控件内的控件的集合。 (继承自 Control) |
| Created |
获取一个值，该值指示控件是否已经创建。 (继承自 Control) |
| CreateParams |
获取创建控件句柄时所需要的创建参数。 |
| Cursor |
获取或设置当鼠标指针位于控件上时显示的光标。 (继承自 Control) |
| CustomFormat |
获取或设置自定义日期/时间格式字符串。 |
| DataBindings |
为该控件获取数据绑定。 (继承自 Control) |
| DataContext |
获取或设置用于数据绑定的数据上下文。 这是一个环境属性。 (继承自 Control) |
| DefaultCursor |
获取或设置控件的默认光标。 (继承自 Control) |
| DefaultImeMode |
获取控件支持的默认输入法编辑器 (IME) 模式。 (继承自 Control) |
| DefaultMargin |
获取控件之间默认指定的间距（以像素为单位）。 (继承自 Control) |
| DefaultMaximumSize |
获取以像素为单位的长度和高度，此长度和高度被指定为控件的默认最大大小。 (继承自 Control) |
| DefaultMinimumSize |
获取以像素为单位的长度和高度，此长度和高度被指定为控件的默认最小大小。 (继承自 Control) |
| DefaultPadding |
获取控件内容的默认内部间距（以像素为单位）。 (继承自 Control) |
| DefaultSize |
获取控件的默认大小。 |
| DesignMode |
获取一个值，用以指示 Component 当前是否处于设计模式。 (继承自 Component) |
| DeviceDpi |
获取显示当前控件的显示设备的 DPI 值。 (继承自 Control) |
| DisplayRectangle |
获取表示控件的显示区域的矩形。 (继承自 Control) |
| Disposing |
获取一个值，该值指示 Control 基类是否在释放进程中。 (继承自 Control) |
| Dock |
获取或设置哪些控件边框停靠到其父控件并确定控件如何随其父级一起调整大小。 (继承自 Control) |
| DoubleBuffered |
获取或设置一个值，该值指示控件是否应使用次要缓冲区重绘其图面。 设置此属性对 DateTimePicker 控件不起任何作用。 |
| DoubleBuffered |
获取或设置一个值，该值指示此控件是否应使用辅助缓冲区重绘其图面，以减少或避免闪烁。 (继承自 Control) |
| DropDownAlign |
获取或设置 DateTimePicker 控件上下拉日历的对齐方式。 |
| Enabled |
获取或设置一个值，该值指示控件是否可以对用户交互作出响应。 (继承自 Control) |
| Events |
获取附加到此 Component 的事件处理程序的列表。 (继承自 Component) |
| Focused |
获取一个值，该值指示控件是否有输入焦点。 (继承自 Control) |
| Font |
获取或设置控件显示的文字的字体。 (继承自 Control) |
| FontHeight |
获取或设置控件的字体的高度。 (继承自 Control) |
| ForeColor |
获取或设置 DateTimePicker 控件的前景色。 |
| Format |
获取或设置控件中显示的日期和时间格式。 |
| Handle |
获取控件绑定到的窗口句柄。 (继承自 Control) |
| HasChildren |
获取一个值，该值指示控件是否包含一个或多个子控件。 (继承自 Control) |
| Height |
获取或设置控件的高度。 (继承自 Control) |
| ImeMode |
获取或设置控件的输入法编辑器 (IME) 模式。 (继承自 Control) |
| ImeModeBase |
获取或设置控件的 IME 模式。 (继承自 Control) |
| InvokeRequired |
获取一个值，该值指示调用方在对控件进行方法调用时是否必须调用 Invoke 方法，因为调用方位于创建控件所在的线程以外的线程中。 (继承自 Control) |
| IsAccessible |
获取或设置一个值，该值指示控件对辅助功能应用程序是否可见。 (继承自 Control) |
| IsAncestorSiteInDesignMode |
指示此控件的上级之一是否位于 DesignMode 中以及该站点。 此属性为只读。 (继承自 Control) |
| IsDisposed |
获取一个值，该值指示控件是否已经被释放。 (继承自 Control) |
| IsHandleCreated |
获取一个值，该值指示控件是否有与它关联的句柄。 (继承自 Control) |
| IsMirrored |
获取一个值，该值指示此控件是否为镜像控件。 (继承自 Control) |
| LayoutEngine |
获取控件的布局引擎的缓存实例。 (继承自 Control) |
| Left |
获取或设置控件左边缘与其容器的工作区左边缘之间的距离（以像素为单位）。 (继承自 Control) |
| Location |
获取或设置该控件的左上角相对于其容器的左上角的坐标。 (继承自 Control) |
| Margin |
获取或设置控件之间的空间。 (继承自 Control) |
| MaxDate |
获取或设置可在控件中选择的最大日期和时间。 |
| MaximumDateTime |
获取 DateTimePicker 控件允许的最大日期值。 |
| MaximumSize |
获取或设置大小，该大小是 GetPreferredSize(Size) 可以指定的上限。 (继承自 Control) |
| MinDate |
获取或设置可在控件中选择的最小日期和时间。 |
| MinimumDateTime |
获取 DateTimePicker 控件允许的最小日期值。 |
| MinimumSize |
获取或设置大小，该大小是 GetPreferredSize(Size) 可以指定的下限。 (继承自 Control) |
| Name |
获取或设置控件的名称。 (继承自 Control) |
| Padding |
获取或设置 DateTimePicker 控件的内容和其边缘之间的间距。 |
| Padding |
获取或设置控件内的空白。 (继承自 Control) |
| Parent |
获取或设置控件的父容器。 (继承自 Control) |
| PreferredHeight |
获取 DateTimePicker 控件的首选高度。 |
| PreferredSize |
获取可以容纳控件的矩形区域的大小。 (继承自 Control) |
| ProductName |
获取包含控件的程序集的产品名称。 (继承自 Control) |
| ProductVersion |
获取包含控件的程序集的版本。 (继承自 Control) |
| RecreatingHandle |
获取一个值，该值指示控件当前是否在重新创建其句柄。 (继承自 Control) |
| Region |
获取或设置与控件关联的窗口区域。 (继承自 Control) |
| RenderRightToLeft |
已过时.
已过时.
此属性现已过时。 (继承自 Control) |
| ResizeRedraw |
获取或设置一个值，该值指示控件在调整大小时是否重绘自己。 (继承自 Control) |
| Right |
获取控件右边缘与其容器的工作区左边缘之间的距离（以像素为单位）。 (继承自 Control) |
| RightToLeft |
获取或设置一个值，该值指示是否将控件的元素对齐以支持使用从右向左的字体的区域设置。 (继承自 Control) |
| RightToLeftLayout |
获取或设置 DateTimePicker 的内容布局是否为从右向左。 |
| ScaleChildren |
获取一个值，该值确定子控件的缩放。 (继承自 Control) |
| ShowCheckBox |
获取或设置一个值，该值指示在选定日期的左侧是否显示一个复选框。 |
| ShowFocusCues |
获取一个值，该值指示控件是否应显示聚焦框。 (继承自 Control) |
| ShowKeyboardCues |
获取一个值，该值指示用户界面是否处于适当的状态以显示或隐藏键盘快捷键。 (继承自 Control) |
| ShowUpDown |
获取或设置一个值，该值指示是否使用数值调节钮控件（也称为 up-down 控件）调整日期/时间值。 |
| Site |
获取或设置控件的站点。 (继承自 Control) |
| Size |
获取或设置控件的高度和宽度。 (继承自 Control) |
| TabIndex |
获取或设置控件在其容器内的 Tab 键顺序。 (继承自 Control) |
| TabStop |
获取或设置一个值，该值指示用户能否使用 Tab 键将焦点放到该控件上。 (继承自 Control) |
| Tag |
获取或设置包含有关控件的数据的对象。 (继承自 Control) |
| Text |
获取或设置与此控件关联的文本。 |
| Top |
获取或设置控件上边缘与其容器的工作区上边缘之间的距离（以像素为单位）。 (继承自 Control) |
| TopLevelControl |
获取没有另一个 Windows 窗体控件作为其父级的父控件。 通常，这是控件所在的最外面的 Form。 (继承自 Control) |
| UseWaitCursor |
获取或设置一个值，该值指示是否将等待光标用于当前控件以及所有子控件。 (继承自 Control) |
| Value |
获取或设置分配给控件的日期/时间值。 |
| Visible |
获取或设置一个值，该值指示是否显示该控件及其所有子控件。 (继承自 Control) |
| Width |
获取或设置控件的宽度。 (继承自 Control) |
| WindowTarget |
此属性与此类无关。 (继承自 Control) |
方法
事件
显式接口实现
| IDropTarget.OnDragDrop(DragEventArgs) |
引发 DragDrop 事件。 (继承自 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引发 DragEnter 事件。 (继承自 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引发 DragLeave 事件。 (继承自 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引发 DragOver 事件。 (继承自 Control) |
