Windows Forms Data Binding

Data binding in Windows Forms gives you the means to display and make changes to information from a data source in controls on the form. You can bind to both traditional data sources as well as almost any structure that contains data.

In This Section

Data Binding and Windows Forms
Provides an overview of data binding in Windows Forms.

Data Sources Supported by Windows Forms
Describes the data sources that can be used with Windows Forms.

Interfaces Related to Data Binding
Describes several of the interfaces used with Windows Forms data binding.

How to: Navigate Data in Windows Forms
Shows how to navigate through items in a data source.

Change Notification in Windows Forms Data Binding
Describes different types of change notification for Windows Forms data binding.

How to: Implement the INotifyPropertyChanged Interface
Shows how to implement the INotifyPropertyChanged interface. The interface communicates to a bound control the property changes on a business object

How to: Apply the PropertyNameChanged Pattern
Shows how to apply the PropertyNameChanged pattern to properties of a Windows Forms user control.

How to: Implement the ITypedList Interface
Shows how to enable discovery of the schema for a bindable list by implementing the ITypedList interface.

How to: Implement the IListSource Interface
Shows how to implement the IListSource interface to create a bindable class does not implement IList, but provides a list from another location.

How to: Ensure Multiple Controls Bound to the Same Data Source Remain Synchronized
Shows how to handle the BindingComplete event to ensure all controls bound to a data source remain synchronized.

How to: Ensure the Selected Row in a Child Table Remains at the Correct Position
Shows how to ensure the selected row of a child table does not change, when a change is made to a field of the parent table.

Reference

System.Windows.Forms.Binding
Describes the class that represents the binding between a bindable component and a data source.

System.Windows.Forms.BindingSource
Describes the class that encapsulates a data source for binding to controls.

Related Sections

BindingSource Component
Contains a list of topics that demonstrate how to use the BindingSource component.

DataGridView Control
Provides a list of topics that demonstrate how to use a bindable datagrid control.

Привязка данных Windows Forms Windows Forms Data Binding

Привязка данных в Windows Forms дает возможность отображать и изменять информацию из источника данных в элементах управления в форме. Data binding in Windows Forms gives you the means to display and make changes to information from a data source in controls on the form. В Windows Forms можно выполнить привязку не только к традиционным источникам данных, но и к практически к любой структуре, содержащий данные. You can bind to both traditional data sources as well as almost any structure that contains data.

в этом разделе In This Section

Связывание данных и Windows Forms Data Binding and Windows Forms
Общие сведения о привязке данных в Windows Forms. Provides an overview of data binding in Windows Forms.

Источники данных, поддерживаемые Windows Forms Data Sources Supported by Windows Forms
Описывает источники данных, которые можно использовать с Windows Forms. Describes the data sources that can be used with Windows Forms.

Интерфейсы, относящиеся к привязке данных Interfaces Related to Data Binding
Описывает некоторые интерфейсы, используемые для привязки данных Windows Forms. Describes several of the interfaces used with Windows Forms data binding.

Практическое руководство. Навигация по набору данных, отображаемых в форме Windows Forms How to: Navigate Data in Windows Forms
Показано, как перемещаться по элементам в источнике данных. Shows how to navigate through items in a data source.

Получение уведомления об изменении данных, связанных с элементом управления, в Windows Forms Change Notification in Windows Forms Data Binding
Описывает различные типы уведомлений об изменении для привязки данных Windows Forms. Describes different types of change notification for Windows Forms data binding.

Практическое руководство. Реализация интерфейса INotifyPropertyChanged How to: Implement the INotifyPropertyChanged Interface
Показано, как реализовать интерфейс INotifyPropertyChanged. Shows how to implement the INotifyPropertyChanged interface. Этот интерфейс сообщает связанному элементу управления об изменениях свойств бизнес-объекта The interface communicates to a bound control the property changes on a business object

Практическое руководство. Применение шаблона PropertyNameChanged How to: Apply the PropertyNameChanged Pattern
Показывает, как применить шаблон » PropertyName Changed» к свойствам Windows Forms пользовательского элемента управления. Shows how to apply the PropertyName Changed pattern to properties of a Windows Forms user control.

Практическое руководство. Реализация интерфейса ITypedList How to: Implement the ITypedList Interface
Показано, как задействовать обнаружение схемы для связываемого списка путем реализации интерфейса ITypedList. Shows how to enable discovery of the schema for a bindable list by implementing the ITypedList interface.

Практическое руководство. Реализация интерфейса IListSource How to: Implement the IListSource Interface
Показано, как реализовать интерфейс IListSource, чтобы создать связываемый класс, который не реализует IList, но предоставляет список из другого расположения. Shows how to implement the IListSource interface to create a bindable class does not implement IList, but provides a list from another location.

Практическое руководство. Синхронизация элементов управления, связанных с одним источником данных How to: Ensure Multiple Controls Bound to the Same Data Source Remain Synchronized
Показано, как обрабатывать событие BindingComplete для обеспечения синхронизация всех элементов управления, привязанных к источнику данных. Shows how to handle the BindingComplete event to ensure all controls bound to a data source remain synchronized.

Практическое руководство. Правильное позиционирование выделенной строки в дочерней таблице How to: Ensure the Selected Row in a Child Table Remains at the Correct Position
Показано, как обеспечить сохранение позиции выбранной строки дочерней таблицы при изменении поля родительской таблицы. Shows how to ensure the selected row of a child table does not change, when a change is made to a field of the parent table.

Справочник Reference

System.Windows.Forms.Binding
Описывает класс, представляющий связку между связываемым компонентом и источником данных. Describes the class that represents the binding between a bindable component and a data source.

System.Windows.Forms.BindingSource
Описывает класс, инкапсулирующий источник данных для привязки к элементам управления. Describes the class that encapsulates a data source for binding to controls.

Связанные разделы Related Sections

Компонент BindingSource BindingSource Component
Содержит список разделов, описывающих использование компонента BindingSource. Contains a list of topics that demonstrate how to use the BindingSource component.

Элемент управления DataGridView DataGridView Control
Предоставляет список разделов, в которых демонстрируется использование связываемого элемента управления datagrid. Provides a list of topics that demonstrate how to use a bindable datagrid control.

Практическое руководство. Отображение и ввод дат с помощью элемента управления 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.

How to: Navigate Data in Windows Forms

In a Windows application, the easiest way to navigate through records in a data source is to bind a BindingSource component to the data source and then bind controls to the BindingSource. You can then use the built-in navigation method on the BindingSource such a MoveNext, MoveLast, MovePrevious and MoveFirst. Using these methods will adjust the Position and Current properties of the BindingSource appropriately. You can also find an item and set it as the current item by setting the Position property.

To increment the position in a data source

Set the Position property of the BindingSource for your bound data to the record position to go to. The following example illustrates using the MoveNext method of the BindingSource to increment the Position property when the nextButton is clicked. The BindingSource is associated with the Customers table of a dataset Northwind .

Setting the Position property to a value beyond the first or last record does not result in an error, as the .NET Framework will not allow you to set the position to a value outside the bounds of the list. If it is important in your application to know whether you have gone past the first or last record, include logic to test whether you will exceed the data element count.

To check whether you have passed the end or beginning

Create an event handler for the PositionChanged event. In the handler, you can test whether the proposed position value has exceeded the actual data element count.

The following example illustrates how you can test whether you have reached the last data element. In the example, if you are at the last element, the Next button on the form is disabled.

Be aware that, should you change the list you are navigating in code, you should re-enable the Next button, so that users may browse the entire length of the new list. Additionally, be aware that the above PositionChanged event for the specific BindingSource you are working with needs to be associated with its event-handling method. The following is an example of a method for handling the PositionChanged event:

To find an item and set it as the current item

Find the record you wish to set as the current item. You can do this using the Find method of the BindingSource, if your data source implements IBindingList. Some examples of data sources that implement IBindingList are BindingList and DataView.

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.