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

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

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

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

При попытке выполнить привязку к свойству, которое не существует, 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.

Исключения

ArgumentException

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

-или-

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

Exception

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

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

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

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.

Исключения

ArgumentException

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

-или-

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

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

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.

Исключения

ArgumentException

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

-или-

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

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

formatString: String

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

Исключения

ArgumentException

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

-или-

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

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

formatString: String

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

formatInfo: IFormatProvider

Реализация IFormatProvider для переопределения стандартного поведения форматирования.

Исключения

ArgumentException

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

-или-

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

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

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

Определение

Перегрузки

Binding(String, Object, String)

Параметры

Исключения

Примеры

Комментарии

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

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

Binding(String, Object, String, Boolean)

Параметры

Исключения

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

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

Параметры

Исключения

Комментарии

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

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

Параметры

Исключения

Комментарии

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

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

Параметры

Исключения

Комментарии

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

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

Параметры

Исключения

Комментарии

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

Дополнительные ресурсы