Date Time Picker. Value Changed Событие

Определение

Происходит при изменении свойства Value. Occurs when the Value property changes.

Тип события

Примеры

В следующем примере кода показано использование этого элемента. The following code example demonstrates the use of this member. В этом примере обработчик событий сообщает о возникновении ValueChanged события. In the example, an event handler reports on the occurrence of the ValueChanged event. Этот отчет поможет вам узнать, когда происходит событие и может помочь при отладке. This report helps you to learn when the event occurs and can assist you in debugging. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рассмотрите возможность замены MessageBox.Show Console.WriteLine или добавления сообщения в многострочный TextBox . To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа DateTimePicker с именем DateTimePicker1 . To run the example code, paste it into a project that contains an instance of type DateTimePicker named DateTimePicker1 . Затем убедитесь, что обработчик событий связан с ValueChanged событием. Then ensure that the event handler is associated with the ValueChanged event.

Комментарии

Входные данные пользователя проверяются до возникновения этого события. User input is validated before this event is raised. Это событие не возникает, когда указанная дата предшествует MinDateTime или позже, чем MaxDateTime . This event is not raised when the entered date is earlier than MinDateTime or later than MaxDateTime.

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий. For more information about handling events, see Handling and Raising Events.

Date Time Picker Format Перечисление

Определение

Задает формат даты и времени, в котором отображается элемент управления DateTimePicker. Specifies the date and time format the DateTimePicker control displays.

Элемент управления DateTimePicker отображает значение даты/времени в пользовательском формате. The DateTimePicker control displays the date/time value in a custom format. Для получения дополнительной информации см. CustomFormat. For more information, see CustomFormat.

Элемент управления DateTimePicker отображает значение даты/времени в длинном формате даты, настроенном в операционной системе пользователя. The DateTimePicker control displays the date/time value in the long date format set by the user’s operating system.

Элемент управления DateTimePicker отображает значение даты/времени в коротком формате даты, настроенном в операционной системе пользователя. The DateTimePicker control displays the date/time value in the short date format set by the user’s operating system.

Элемент управления DateTimePicker отображает значение даты/времени в формате времени, настроенном в операционной системе пользователя. The DateTimePicker control displays the date/time value in the time format set by the user’s operating system.

Примеры

В следующем примере кода демонстрируется инициализация DateTimePicker объекта путем присвоения объекту Format DateTimePickerFormat значения. The following code example demonstrates initializing a DateTimePicker object by setting the Format to a DateTimePickerFormat value. Чтобы выполнить этот пример, вставьте следующий код в форму и вызовите InitializeDateTimePicker метод из конструктора формы или Load метода обработки событий. To run this example paste the following code in a form and call InitializeDateTimePicker from the form’s constructor or Load event-handling method.

Комментарии

Это перечисление используется такими элементами, как DateTimePicker.Format . This enumeration is used by members such as DateTimePicker.Format.

Фактические форматы даты и времени определяются по дате, времени и региональным параметрам, заданным в операционной системе пользователя. The actual date/time formats are determined by the date, time, and regional settings set in the user’s operating system.

Практическое руководство. Отображение и ввод дат с помощью элемента управления DateTimePicker в Windows Forms How to: Set and Return Dates with the Windows Forms DateTimePicker Control

Текущая выбранная дата или время в элементе управления Windows Forms DateTimePicker определяется свойством Value. The currently selected date or time in the Windows Forms DateTimePicker control is determined by the Value property. Перед отображением элемента управления можно задать свойство Value (например, во время разработки или в виде событий Load) для определения даты, которая изначально будет выбрана в элементе управления. You can set the Value property before the control is displayed (for example, at design time or in the form’s Load event) to determine which date will be initially selected in the control. По умолчанию в свойстве Value элемента управления установлена текущая дата. By default, the control’s Value is set to the current date. Если свойство Value элемента управления изменяется в коде, элемент управления автоматически обновляется, отображая новое значение в форме. If you change the control’s Value in code, the control is automatically updated on the form to reflect the new setting.

Свойство Value возвращает структуру DateTime, которая является его значением. The Value property returns a DateTime structure as its value. Существует несколько свойств структуры DateTime, возвращающих определенные сведения об отображаемой дате. There are several properties of the DateTime structure that return specific information about the displayed date. Эти свойства можно использовать только для возврата значения; не используйте их для задания значения. These properties can only be used to return a value; do not use them to set a value.

Для значений даты свойства Month, Day и Year возвращают целочисленные значения в единицах времени выбранной даты. For date values, the Month, Day, and Year properties return integer values for those time units of the selected date. Свойство DayOfWeek возвращает значение, указывающее выбранный день недели (возможные значения указаны в перечислении DayOfWeek). The DayOfWeek property returns a value indicating the selected day of the week (possible values are listed in the DayOfWeek enumeration).

Для значений времени свойства Hour, Minute, Second и Millisecond возвращают целочисленные значения для единиц времени. For time values, the Hour, Minute, Second, and Millisecond properties return integer values for those time units. Чтобы настроить отображение времени в элементе управления, см. раздел как отобразить время с помощью элемента управления DateTimePicker. To configure the control to display times, see How to: Display Time with the DateTimePicker Control.

Указание значения даты и времени элемента управления To set the date and time value of the control

Установите для свойства Value значение даты или времени. Set the Value property to a date or time value.

Возврат значения даты и времени To return the date and time value

Вызовите свойство Text для возврата всего значения в формате элемента управления или вызовите соответствующий метод свойства Value для возврата части значения. Call the Text property to return the entire value as formatted in the control, or call the appropriate method of the Value property to return a part of the value. Используйте ToString для преобразования данных в строку, которую можно вывести пользователю. Use ToString to convert the information into a string that can be displayed to the user.

Date Time Picker. Custom Format Свойство

Определение

Возвращает или задает строку пользовательского формата даты и времени. Gets or sets the custom date/time format string.

Значение свойства

Строка, которая представляет собой пользовательский формат даты и времени. A string that represents the custom date/time format. Значение по умолчанию — null . The default is null .

Примеры

В следующем примере кода свойство задается CustomFormat таким образом, чтобы DateTimePicker дата отображалась как «Июнь 01, 2001-пятница». The following code example sets the CustomFormat property so that the DateTimePicker will display the date as «June 01, 2001 — Friday». В этом коде предполагается, что экземпляр DateTimePicker элемента управления был создан на Form . This code assumes that an instance of a DateTimePicker control has been created on a Form.

Комментарии

Чтобы отобразить строковые литералы, содержащие разделители даты и времени, или строки формата, необходимо использовать escape-символы в подстроке. To display string literals that contain date and time separators or to format strings, you must use escape characters in the substring. Например, чтобы отобразить дату «15 июня в 12:00 PM», задайте CustomFormat для свойства значение «мммм дд» в «т:мм TT». For example, to display the date as «June 15 at 12:00 PM», set the CustomFormat property to «MMMM dd ‘at’ t:mm tt». Если подстрока «at» не заключена в escape-символы, результатом является «15 июня aP 12:12:00», так как символ «t» читается как однобуквенный/P.M. If the «at» substring is not enclosed by escape characters, the result is «June 15 aP 12:00PM» because the «t» character is read as the one-letter A.M./P.M. Строка формата (см. таблицу строка формата ниже). format string (see the format string table below).

Строки формата можно комбинировать для форматирования даты и времени. The format strings can be combined to format the date and time. Например, чтобы отобразить дату и время как 06/15/2001 12:00 PM, это свойство должно иметь значение «MM»/»DD»/»гггг чч»: «mm tt». For example, to display the date and time as 06/15/2001 12:00 PM, this property should be set to «MM’/’dd’/’yyyy hh’:’mm tt». Дополнительные сведения см. в разделе строки настраиваемых форматов даты и времени. For more information, see Custom Date and Time Format Strings.

FormatСвойство должно иметь значение, чтобы DateTimePickerFormat.Custom это свойство влияло на форматирование отображаемых даты и времени. The Format property must be set to DateTimePickerFormat.Custom for this property to affect the formatting of the displayed date and time.

В следующей таблице перечислены все допустимые строки формата и их описания. The following table lists all the valid format strings and their descriptions.

Date Time Picker. Format Свойство

Определение

Возвращает или задает формат даты и времени, отображаемых в элементе управления. Gets or sets the format of the date and time displayed in the control.

Значение свойства

Одно из значений перечисления DateTimePickerFormat. One of the DateTimePickerFormat values. Значение по умолчанию — Long. The default is Long.

Исключения

Назначенное значение не является одном из значений DateTimePickerFormat. The value assigned is not one of the DateTimePickerFormat values.

Примеры

В следующем примере кода свойство задается CustomFormat таким образом, чтобы DateTimePicker дата отображалась как «Июнь 01, 2001-пятница». The following code example sets the CustomFormat property so that the DateTimePicker will display the date as «June 01, 2001 — Friday». В этом коде предполагается, что экземпляр DateTimePicker элемента управления был создан на Form . This code assumes that an instance of a DateTimePicker control has been created on a Form.

Комментарии

Это свойство определяет формат даты и времени, в котором отображается дата. This property determines the date/time format the date is displayed in. Формат даты-времени основан на региональных параметрах пользователя в операционной системе. The date/time format is based on the user’s regional settings in their operating system.

FormatСвойство должно иметь значение, чтобы DateTimePickerFormat.Custom CustomFormat свойство влияло на форматирование отображаемых даты и времени. The Format property must be set to DateTimePickerFormat.Custom for the CustomFormat property to affect the formatting of the displayed date and time.

Чтобы отображалось только время в DateTimePicker , присвойте Format Time свойству значение и значение ShowUpDown true . To display only time in a DateTimePicker, set the Format to Time, and the ShowUpDown property to true .