Поделиться через


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

Определение

Инициализирует новый экземпляр класса 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);
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

Привязываемое свойство или список.

Исключения

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

Свойство, заданное параметром 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

Комментарии

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

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

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

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

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

Применяется к

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);
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.

Исключения

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

-или-

Свойство доступно только для чтения.

Форматирование отключено и значение 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);
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.

Исключения

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

-или-

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

Комментарии

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

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

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

Применяется к

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);
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.

Исключения

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

-или-

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

Комментарии

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

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

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

Применяется к

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);
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

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

Исключения

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

-или-

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

Комментарии

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

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

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

Применяется к

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);
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 для переопределения стандартного поведения форматирования.

Исключения

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

-или-

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

Комментарии

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

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

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

Применяется к