Binding Конструкторы

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Инициализирует новый экземпляр класса Binding.

Перегрузки

Имя	Описание
Binding(String, Object, String)	Инициализирует новый экземпляр Binding класса, который просто привязывает указанное свойство элемента управления к указанному члену данных источника данных.
Binding(String, Object, String, Boolean)	Инициализирует новый экземпляр Binding класса, который привязывает указанное свойство элемента управления к указанному члену данных источника данных и при необходимости позволяет применять форматирование.
Binding(String, Object, String, Boolean, DataSourceUpdateMode)	Инициализирует новый экземпляр Binding класса, который привязывает указанное свойство элемента управления к указанному элементу данных указанного источника данных. При необходимости включает форматирование и распространяет значения в источник данных на основе указанного параметра обновления.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Инициализирует новый экземпляр Binding класса, который привязывает указанное свойство элемента управления к указанному элементу данных указанного источника данных. При необходимости включает форматирование, распространяет значения в источник данных на основе указанного параметра обновления и задает свойство заданному значению при DBNull возврате из источника данных.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Инициализирует новый экземпляр Binding класса, который привязывает указанное свойство элемента управления к указанному элементу данных указанного источника данных. При необходимости включает форматирование с указанной строкой формата; распространяет значения в источник данных на основе указанного параметра обновления; и задает свойство указанному значению, когда DBNull возвращается из источника данных.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Инициализирует новый экземпляр Binding класса с указанным свойством элемента управления указанным элементом данных указанного источника данных. При необходимости включает форматирование с указанной строкой формата; распространяет значения в источник данных на основе указанного параметра обновления; включает форматирование с указанной строкой формата; задает свойство заданному значению, когда DBNull возвращается из источника данных; и задает указанный поставщик формата.

Binding(String, Object, String)

Исходный код:

Binding.cs

Инициализирует новый экземпляр Binding класса, который просто привязывает указанное свойство элемента управления к указанному члену данных источника данных.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember);

public Binding(string propertyName, object? dataSource, string? dataMember);

new System.Windows.Forms.Binding : string * obj * string -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String)

Параметры

propertyName

String

Имя свойства элемента управления для привязки.

dataSource

Object

Объект, Object представляющий источник данных.

dataMember

String

Свойство или список для привязки.

Исключения

Exception

propertyName не является допустимым свойством элемента управления или пустой строкой ("").

ArgumentException

Свойство, заданное propertyName элементом управления, не существует.

Примеры

В следующем примере кода элемент управления привязывается TextBox к столбцу таблицы в именованном коде DataSetmyDataSet. В примере требуется, чтобы вы объявили myDataSet в разделе объявлений модуля.

private:
   void CreateDataSet()
   {
      myDataSet = gcnew DataSet( "myDataSet" );
      /* Populates the DataSet with tables, relations, and 
         constraints. */
   }

   void BindTextBoxToDataSet()
   {
      /* Binds a TextBox control to a DataColumn named
      CompanyName in the DataTable named Suppliers. */
      textBox1->DataBindings->Add(
         "Text", myDataSet, "Suppliers.CompanyName" );
   }

private void CreateDataSet()
{
   myDataSet = new DataSet("myDataSet");
   /* Populates the DataSet with tables, relations, and 
      constraints. */
}

private void BindTextBoxToDataSet()
{
   /* Binds a TextBox control to a DataColumn named
   CompanyName in the DataTable named Suppliers. */
   textBox1.DataBindings.Add
   ("Text", myDataSet, "Suppliers.CompanyName");
}

Private Sub CreateDataSet
   myDataSet = new DataSet("myDataSet")
   ' Populates the DataSet with tables, relations, and
   ' constraints.
End Sub

Private Sub BindTextBoxToDataSet 
   ' Binds a TextBox control to a column in the DataSet.
   textBox1.DataBindings.Add _
   ("Text", myDataSet, "Suppliers.CompanyName")
End Sub

Комментарии

Можно указать экземпляр любого из следующих классов для источника данных:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Любой класс, реализующий IList интерфейс

• Любой класс

Дополнительные сведения о создании Binding строки см. в dataMember классе.

При создании привязки к свойству элемента управления новые Binding проверяют события, предоставляемые ограничивающим элементом управления, и присоединяются к двум конкретным событиям:

• Control.Validating

• Событие с именем PropertyNameChanged (например, Control.BackColorChanged)

Если вы пытаетесь привязаться к свойству, которое не существует, ArgumentException при добавлении в коллекцию элемента управления Binding будет возникать исключениеControl.DataBindings.

См. также раздел

• BindingsCollection
• CurrencyManager

Binding(String, Object, String, Boolean)

Исходный код:

Binding.cs

Инициализирует новый экземпляр Binding класса, который привязывает указанное свойство элемента управления к указанному члену данных источника данных и при необходимости позволяет применять форматирование.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled);

public Binding(string propertyName, object? dataSource, string? dataMember, bool formattingEnabled);

new System.Windows.Forms.Binding : string * obj * string * bool -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean)

Параметры

propertyName

String

Имя свойства элемента управления для привязки.

dataSource

Object

Объект, Object представляющий источник данных.

dataMember

String

Свойство или список для привязки.

formattingEnabled

Boolean

true форматирование отображаемых данных; falseв противном случае .

Исключения

ArgumentException

Свойство, заданное propertyName элементом управления, не существует.

–или–

Данное свойство — это свойство, доступное только для чтения.

Exception

Форматирование отключено и propertyName не является допустимым свойством элемента управления или пустой строкой ("").

Binding(String, Object, String, Boolean, DataSourceUpdateMode)

Исходный код:

Binding.cs

Инициализирует новый экземпляр Binding класса, который привязывает указанное свойство элемента управления к указанному элементу данных указанного источника данных. При необходимости включает форматирование и распространяет значения в источник данных на основе указанного параметра обновления.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode);

public Binding(string propertyName, object? dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode);

new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode)

Параметры

propertyName

String

Имя свойства элемента управления для привязки.

dataSource

Object

Представляет Object источник данных.

dataMember

String

Свойство или список для привязки.

formattingEnabled

Boolean

true форматирование отображаемых данных; falseв противном случае .

dataSourceUpdateMode

DataSourceUpdateMode

Одно из значений DataSourceUpdateMode .

Исключения

ArgumentException

Свойство, заданное propertyName элементом управления, не существует.

–или–

Указанный источник данных или элемент управления или свойство элемента управления связаны с другой привязкой в коллекции.

Комментарии

Можно указать экземпляр любого из следующих классов для источника данных:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Любой класс, реализующий IList интерфейс

• Любой класс

Дополнительные сведения о создании Binding строки см. в dataMember классе.

При создании привязки к свойству элемента управления новые Binding проверяют события, предоставляемые ограничивающим элементом управления, и присоединяются к двум конкретным событиям:

• Control.Validating.

• Событие с именем PropertyNameChanged (например, Control.BackColorChanged)

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Исходный код:

Binding.cs

Инициализирует новый экземпляр Binding класса, который привязывает указанное свойство элемента управления к указанному элементу данных указанного источника данных. При необходимости включает форматирование, распространяет значения в источник данных на основе указанного параметра обновления и задает свойство заданному значению при DBNull возврате из источника данных.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode, System::Object ^ nullValue);

public Binding(string propertyName, object? dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object? nullValue);

new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object)

Параметры

propertyName

String

Имя свойства элемента управления для привязки.

dataSource

Object

Представляет Object источник данных.

dataMember

String

Свойство или список для привязки.

formattingEnabled

Boolean

true форматирование отображаемых данных; falseв противном случае .

dataSourceUpdateMode

DataSourceUpdateMode

Одно из значений DataSourceUpdateMode .

nullValue

Object

Применяется Object к свойству привязанного элемента управления, если значение источника данных равно DBNull.

Исключения

ArgumentException

Свойство, заданное propertyName элементом управления, не существует.

–или–

Указанный источник данных или элемент управления или свойство элемента управления связаны с другой привязкой в коллекции.

Комментарии

Можно указать экземпляр любого из следующих классов для источника данных:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Любой класс, реализующий IList интерфейс

• Любой класс

Дополнительные сведения о создании Binding строки см. в dataMember классе.

При создании привязки к свойству элемента управления новые Binding проверяют события, предоставляемые ограничивающим элементом управления, и присоединяются к двум конкретным событиям:

• Control.Validating

• Событие с именем PropertyNameChanged (например, Control.BackColorChanged)

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Исходный код:

Binding.cs

Инициализирует новый экземпляр Binding класса, который привязывает указанное свойство элемента управления к указанному элементу данных указанного источника данных. При необходимости включает форматирование с указанной строкой формата; распространяет значения в источник данных на основе указанного параметра обновления; и задает свойство указанному значению, когда DBNull возвращается из источника данных.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode, System::Object ^ nullValue, System::String ^ formatString);

public Binding(string propertyName, object? dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object? nullValue, string formatString);

new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object, formatString As String)

Параметры

propertyName

String

Имя свойства элемента управления для привязки.

dataSource

Object

Представляет Object источник данных.

dataMember

String

Свойство или список для привязки.

formattingEnabled

Boolean

true форматирование отображаемых данных; falseв противном случае .

dataSourceUpdateMode

DataSourceUpdateMode

Одно из значений DataSourceUpdateMode .

nullValue

Object

Применяется Object к свойству привязанного элемента управления, если значение источника данных равно DBNull.

formatString

String

Один или несколько символов описателя формата, указывающих, как должно отображаться значение.

Исключения

ArgumentException

Свойство, заданное propertyName элементом управления, не существует.

–или–

Указанный источник данных или элемент управления или свойство элемента управления связаны с другой привязкой в коллекции.

Комментарии

Можно указать экземпляр любого из следующих классов для источника данных:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Любой класс, реализующий IList интерфейс

• Любой класс

Дополнительные сведения о создании Binding строки см. в dataMember классе.

При создании привязки к свойству элемента управления новые Binding проверяют события, предоставляемые ограничивающим элементом управления, и присоединяются к двум конкретным событиям:

• Control.Validating

• Событие с именем PropertyNameChanged (например, Control.BackColorChanged)

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)

Исходный код:

Binding.cs

Инициализирует новый экземпляр Binding класса с указанным свойством элемента управления указанным элементом данных указанного источника данных. При необходимости включает форматирование с указанной строкой формата; распространяет значения в источник данных на основе указанного параметра обновления; включает форматирование с указанной строкой формата; задает свойство заданному значению, когда DBNull возвращается из источника данных; и задает указанный поставщик формата.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode, System::Object ^ nullValue, System::String ^ formatString, IFormatProvider ^ formatInfo);

public Binding(string propertyName, object? dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object? nullValue, string formatString, IFormatProvider? formatInfo);

new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string * IFormatProvider -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object, formatString As String, formatInfo As IFormatProvider)

Параметры

propertyName

String

Имя свойства элемента управления для привязки.

dataSource

Object

Представляет Object источник данных.

dataMember

String

Свойство или список для привязки.

formattingEnabled

Boolean

true форматирование отображаемых данных; falseв противном случае .

dataSourceUpdateMode

DataSourceUpdateMode

Одно из значений DataSourceUpdateMode .

nullValue

Object

Применяется Object к свойству привязанного элемента управления, если значение источника данных равно DBNull.

formatString

String

Один или несколько символов описателя формата, указывающих, как должно отображаться значение.

formatInfo

IFormatProvider

Реализация IFormatProvider переопределения поведения форматирования по умолчанию.

Исключения

ArgumentException

Свойство, заданное propertyName элементом управления, не существует.

–или–

Указанный источник данных или элемент управления или свойство элемента управления связаны с другой привязкой в коллекции.

Комментарии

Можно указать экземпляр любого из следующих классов для источника данных:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Любой класс, реализующий IList интерфейс

• Любой класс

Дополнительные сведения о создании Binding строки см. в dataMember классе.

При создании привязки к свойству элемента управления новые Binding проверяют события, предоставляемые ограничивающим элементом управления, и присоединяются к двум конкретным событиям:

• Control.Validating

• Событие с именем PropertyNameChanged (например, Control.BackColorChanged)