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, выполняющего простую привязку указанного свойства элемента управления к указанным данным-члену для указанного источника данных.

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 к столбцу таблицы в DataSet с именем myDataSet. Для этого примера требуется, чтобы вы объявили 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, выполняющего простую привязку указанного свойства элемента управления к указанным данным для указанного источника данных и при необходимости включает применение форматирования.

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, выполняющего привязку указанного свойства элемента управления к указанным данным заданного источника данных. При необходимости включает форматирование и выполняет распространение значений в источник данных на основе заданного значения параметра обновления.

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, выполняющего привязку указанного свойства элемента управления к указанным данным заданного источника данных. При необходимости включает форматирование, распространяет значения в источник данных на основе заданного значения параметра обновления, а также присваивает этому свойству указанное значение при возвращении значения 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, выполняющего привязку указанного свойства элемента управления к указанным данным заданного источника данных. При необходимости включает форматирование с заданной строкой формата, распространяет значения в источник данных на основе заданного значения параметра обновления, а также присваивает этому свойству указанное значение при возвращении значения 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, выполняющего привязку указанного свойства элемента управления к указанным данным заданного источника данных. При необходимости включает форматирование с заданной строкой форматирования; распространяет значения в источник данных на основе заданного параметра обновления; включает форматирование с заданной строкой форматирования; присваивает свойству заданное значение при возвращении значения 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)