DateTimePicker-Klasse
Stellt ein Windows-Steuerelement dar, mit dem Benutzer ein Datum und eine Uhrzeit auswählen und diese in einem angegebenen Format anzeigen können.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Syntax
'Declaration
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<ComVisibleAttribute(True)> _
Public Class DateTimePicker
Inherits Control
'Usage
Dim instance As DateTimePicker
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[ComVisibleAttribute(true)]
public class DateTimePicker : Control
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)]
[ComVisibleAttribute(true)]
public ref class DateTimePicker : public Control
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
/** @attribute ComVisibleAttribute(true) */
public class DateTimePicker extends Control
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)
ComVisibleAttribute(true)
public class DateTimePicker extends Control
Hinweise
Mit dem DateTimePicker-Steuerelement können Benutzer Datum und Uhrzeit auswählen und diese im angegebenen Format anzeigen. Die zur Wahl stehenden Datums- und Zeitangaben lassen sich durch Festlegen der MinDate-Eigenschaft und der MaxDate-Eigenschaft einschränken.
Sie können die Darstellung des Kalenderteils des Steuerelements ändern, indem Sie die CalendarForeColor-Eigenschaft, die CalendarFont-Eigenschaft, die CalendarTitleBackColor-Eigenschaft, die CalendarTitleForeColor-Eigenschaft, die CalendarTrailingForeColor-Eigenschaft und die CalendarMonthBackground-Eigenschaft festlegen.
Die Format-Eigenschaft legt das DateTimePickerFormat des Steuerelements fest. Das Format des Standarddatums ist DateTimePickerFormat.Long. Wenn die Format-Eigenschaft auf DateTimePickerFormat.Custom festgelegt ist, können Sie einen eigenen Formatstil erstellen, indem Sie die CustomFormat-Eigenschaft festlegen und eine benutzerdefinierte Formatzeichenfolge erstellen. Die benutzerdefinierte Formatzeichenfolge kann aus einer Kombination von benutzerdefinierten Feldzeichen und anderen Literalzeichen bestehen. Sie können z. B. das Datum als "Juni 01, 2001 - Freitag" anzeigen lassen, indem Sie die CustomFormat-Eigenschaft auf "MMMM dd, yyyy - dddd" festlegen. Weitere Informationen finden Sie unter Formatzeichenfolgen für Datum und Uhrzeit.
Wenn der Wert für Datum und Uhrzeit mithilfe eines Drehfeldsteuerelements (auch als Auf-Ab-Steuerelement bezeichnet) angepasst werden soll, legen Sie die ShowUpDown-Eigenschaft auf true fest. Das Kalender-Steuerelement wird bei Auswahl des Steuerelements nicht als Dropdown geöffnet. Das Datum und die Uhrzeit können angepasst werden, indem die einzelnen Elemente ausgewählt und der Wert mit den Auf- und Ab-Schaltflächen geändert wird.
Wenn Sie das Datum benutzerdefiniert formatieren müssen, um beispielsweise die Auswahl auf nur ein Datum zu beschränken, ist es u. U. sinnvoll, ein DateTimePicker-Steuerelement statt eines MonthCalendar zu verwenden. Die Verwendung des DateTimePicker vermindert den Validierungsaufwand für Datums- und Uhrzeitwerte.
Hinweis
Das DateTimePicker-Steuerelement unterstützt nur gregorianische Kalender.
Beispiel
Im folgenden Beispiel wird eine neue Instanz eines DateTimePicker-Steuerelements erstellt und initialisiert. Die CustomFormat-Eigenschaft des Steuerelements ist festgelegt. Außerdem ist die ShowCheckBox-Eigenschaft festgelegt, sodass im Steuerelement eine CheckBox angezeigt wird, wie auch die ShowUpDown-Eigenschaft, sodass das Steuerelement als Drehfeldsteuerelement (auch als Auf-Ab-Steuerelement bezeichnet) angezeigt wird.
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 'CreateMyDateTimePicker
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:
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.set_MinDate(new DateTime(1985, 6, 20));
dateTimePicker1.set_MaxDate(DateTime.get_Today());
// Set the CustomFormat string.
dateTimePicker1.set_CustomFormat("MMMM dd, yyyy - dddd");
dateTimePicker1.set_Format(DateTimePickerFormat.Custom);
// Show the CheckBox and display the control as an up-down control.
dateTimePicker1.set_ShowCheckBox(true);
dateTimePicker1.set_ShowUpDown(true);
} //CreateMyDateTimePicker
Vererbungshierarchie
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.DateTimePicker
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0