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


ControlBindingsCollection.Add Метод

Определение

Добавляет Binding в коллекцию.

Перегрузки

Add(Binding)

Добавляет указанный параметр Binding в коллекцию.

Add(String, Object, String)

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

Add(String, Object, String, Boolean)

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

Add(String, Object, String, Boolean, DataSourceUpdateMode)

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

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)

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

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

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

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

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

Add(Binding)

Добавляет указанный параметр Binding в коллекцию.

public:
 void Add(System::Windows::Forms::Binding ^ binding);
public void Add (System.Windows.Forms.Binding binding);
override this.Add : System.Windows.Forms.Binding -> unit
Public Sub Add (binding As Binding)

Параметры

binding
Binding

Добавляемый объект Binding.

Исключения

Значением параметра binding является null.

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

-или-

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

Примеры

В следующем примере кода создается Binding экземпляр и используется Add метод для добавления экземпляра в ControlBindingsCollectionTextBox элемент управления .

protected:
   void BindControls()
   {
      /* Create a new Binding using the DataSet and a 
         navigation path(TableName.RelationName.ColumnName).
         Add event delegates for the Parse and Format events to 
         the Binding object, and add the object to the third 
         TextBox control's BindingsCollection. The delegates 
         must be added before adding the Binding to the 
         collection; otherwise, no formatting occurs until 
         the Current object of the BindingManagerBase for 
         the data source changes. */
      Binding^ b = gcnew Binding(
         "Text",ds,"customers.custToOrders.OrderAmount" );
      b->Parse += gcnew ConvertEventHandler(
         this, &Form1::CurrencyStringToDecimal );
      b->Format += gcnew ConvertEventHandler(
         this, &Form1::DecimalToCurrencyString );
      textBox1->DataBindings->Add( b );
   }
protected void BindControls()
{
   /* Create a new Binding using the DataSet and a 
   navigation path(TableName.RelationName.ColumnName).
   Add event delegates for the Parse and Format events to 
   the Binding object, and add the object to the third 
   TextBox control's BindingsCollection. The delegates 
   must be added before adding the Binding to the 
   collection; otherwise, no formatting occurs until 
   the Current object of the BindingManagerBase for 
   the data source changes. */
   Binding b = new Binding
   ("Text", ds, "customers.custToOrders.OrderAmount");
   b.Parse+=new ConvertEventHandler(CurrencyStringToDecimal);
   b.Format+=new ConvertEventHandler(DecimalToCurrencyString);
   textBox1.DataBindings.Add(b);
}
Protected Sub BindControls()
    ' Create a new Binding using the DataSet and a 
    ' navigation path(TableName.RelationName.ColumnName).
    ' Add event delegates for the Parse and Format events to 
    ' the Binding object, and add the object to the third 
    ' TextBox control's BindingsCollection. The delegates 
    ' must be added before adding the Binding to the 
    ' collection; otherwise, no formatting occurs until 
    ' the Current object of the BindingManagerBase for 
    ' the data source changes. 
    Dim b As New Binding("Text", ds, "customers.custToOrders.OrderAmount")
    AddHandler b.Parse, AddressOf CurrencyStringToDecimal
    AddHandler b.Format, AddressOf DecimalToCurrencyString
    textBox1.DataBindings.Add(b)
End Sub

Комментарии

Свойству DataSourceUpdateMode объекта , созданному Binding данной перегрузкой Add метода , присваивается значение DefaultDataSourceUpdateMode свойства .

Событие CollectionChanged возникает после завершения изменения.

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

Add(String, Object, String)

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

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember);
override this.Add : string * obj * string -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String) As Binding

Параметры

propertyName
String

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

dataSource
Object

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

dataMember
String

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

Возвращаемое значение

Вновь созданный Binding.

Исключения

Значение параметра bindingnull.

Свойство propertyName уже привязано к данным.

-или-

Значение параметра dataMember не задает допустимый член для параметра dataSource.

Примеры

В следующем примере кода метод используется Add для добавления трех Binding объектов в ControlBindingsCollectionTextBox элемент управления . Доступ к коллекции ControlBindingsCollection осуществляется с помощью свойства DataBindings класса Control.

private:
   void BindTextBoxProperties()
   {
      // Clear the collection before adding new Binding objects.
      textBox1->DataBindings->Clear();

      // Create a DataTable containing Color objects.
      DataTable^ t = MakeTable();

      /* Bind the Text, BackColor, and ForeColor properties
         to columns in the DataTable. */
      textBox1->DataBindings->Add( "Text", t, "Text" );
      textBox1->DataBindings->Add( "BackColor", t, "BackColor" );
      textBox1->DataBindings->Add( "ForeColor", t, "ForeColor" );
   }

   DataTable^ MakeTable()
   {
      /* Create a DataTable with three columns.
         Two of the columns contain Color objects. */
      DataTable^ t = gcnew DataTable( "Control" );
      t->Columns->Add( "BackColor", Color::typeid );
      t->Columns->Add( "ForeColor", Color::typeid );
      t->Columns->Add( "Text" );

      // Add three rows to the table.
      DataRow^ r;
      r = t->NewRow();
      r[ "BackColor" ] = Color::Blue;
      r[ "ForeColor" ] = Color::Yellow;
      r[ "Text" ] = "Yellow on Blue";
      t->Rows->Add( r );
      r = t->NewRow();
      r[ "BackColor" ] = Color::White;
      r[ "ForeColor" ] = Color::Green;
      r[ "Text" ] = "Green on white";
      t->Rows->Add( r );
      r = t->NewRow();
      r[ "BackColor" ] = Color::Orange;
      r[ "ForeColor" ] = Color::Black;
      r[ "Text" ] = "Black on Orange";
      t->Rows->Add( r );
      return t;
   }
private void BindTextBoxProperties()
{
   // Clear the collection before adding new Binding objects.
   textBox1.DataBindings.Clear();

   // Create a DataTable containing Color objects.
   DataTable t = MakeTable();

   /* Bind the Text, BackColor, and ForeColor properties
   to columns in the DataTable. */
   textBox1.DataBindings.Add("Text", t, "Text");
   textBox1.DataBindings.Add("BackColor", t, "BackColor");
   textBox1.DataBindings.Add("ForeColor", t, "ForeColor");
}

private DataTable MakeTable()
{
   /* Create a DataTable with three columns.
   Two of the columns contain Color objects. */

   DataTable t = new DataTable("Control");
   t.Columns.Add("BackColor", typeof(Color));
   t.Columns.Add("ForeColor", typeof(Color));
   t.Columns.Add("Text");

   // Add three rows to the table.
   DataRow r;

   r = t.NewRow();
   r["BackColor"] = Color.Blue;
   r["ForeColor"] = Color.Yellow;
   r["Text"] = "Yellow on Blue";
   t.Rows.Add(r);

   r = t.NewRow();
   r["BackColor"] = Color.White;
   r["ForeColor"] = Color.Green;
   r["Text"] = "Green on white";
   t.Rows.Add(r);

   r = t.NewRow();
   r["BackColor"] = Color.Orange;
   r["ForeColor"] = Color.Black;
   r["Text"] = "Black on Orange";
   t.Rows.Add(r);

   return t;
}
Private Sub BindTextBoxProperties()
    ' Clear the collection before adding new Binding objects.
    textBox1.DataBindings.Clear()
    
    ' Create a DataTable containing Color objects.
    Dim t As DataTable = MakeTable()
    
    ' Bind the Text, BackColor, and ForeColor properties
    ' to columns in the DataTable. 
    textBox1.DataBindings.Add("Text", t, "Text")
    textBox1.DataBindings.Add("BackColor", t, "BackColor")
    textBox1.DataBindings.Add("ForeColor", t, "ForeColor")
End Sub    

Private Function MakeTable() As DataTable
    ' Create a DataTable with three columns.
    ' Two of the columns contain Color objects. 
    
    Dim t As New DataTable("Control")
    t.Columns.Add("BackColor", GetType(Color))
    t.Columns.Add("ForeColor", GetType(Color))
    t.Columns.Add("Text")
    
    ' Add three rows to the table.
    Dim r As DataRow
    
    r = t.NewRow()
    r("BackColor") = Color.Blue
    r("ForeColor") = Color.Yellow
    r("Text") = "Yellow on Blue"
    t.Rows.Add(r)
    
    r = t.NewRow()
    r("BackColor") = Color.White
    r("ForeColor") = Color.Green
    r("Text") = "Green on white"
    t.Rows.Add(r)
    
    r = t.NewRow()
    r("BackColor") = Color.Orange
    r("ForeColor") = Color.Black
    r("Text") = "Black on Orange"
    t.Rows.Add(r)
    
    Return t
End Function

Комментарии

Свойству DataSourceUpdateMode объекта , созданному Binding данной перегрузкой Add метода , присваивается значение DefaultDataSourceUpdateMode свойства .

Binding Добавление приводит к возникновению CollectionChanged события.

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

Add(String, Object, String, Boolean)

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

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled);
override this.Add : string * obj * string * bool -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean) As Binding

Параметры

propertyName
String

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

dataSource
Object

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

dataMember
String

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

formattingEnabled
Boolean

Значение true для форматирования отображаемых данных, в противном случае — значение false.

Возвращаемое значение

Вновь созданный Binding.

Исключения

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

-или-

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

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

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

Add(String, Object, String, Boolean, DataSourceUpdateMode)

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

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode) As Binding

Параметры

propertyName
String

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

dataSource
Object

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

dataMember
String

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

formattingEnabled
Boolean

Значение true для форматирования отображаемых данных, в противном случае — значение false.

updateMode
DataSourceUpdateMode

Одно из значений перечисления DataSourceUpdateMode.

Возвращаемое значение

Вновь созданный Binding.

Исключения

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

-или-

Заданный член данных не существует для источника данных.

-или-

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

Комментарии

Add Вызов метода вызывает CollectionChanged событие .

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

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)

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

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object) As Binding

Параметры

propertyName
String

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

dataSource
Object

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

dataMember
String

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

formattingEnabled
Boolean

Значение true для форматирования отображаемых данных, в противном случае — значение false.

updateMode
DataSourceUpdateMode

Одно из значений перечисления DataSourceUpdateMode.

nullValue
Object

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

Возвращаемое значение

Вновь созданный Binding.

Исключения

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

-или-

Заданный член данных не существует для источника данных.

-или-

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

Комментарии

Add Вызов метода вызывает CollectionChanged событие .

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

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

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

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue, System::String ^ formatString);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue, string formatString);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue, string formatString);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object, formatString As String) As Binding

Параметры

propertyName
String

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

dataSource
Object

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

dataMember
String

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

formattingEnabled
Boolean

Значение true для форматирования отображаемых данных, в противном случае — значение false.

updateMode
DataSourceUpdateMode

Одно из значений перечисления DataSourceUpdateMode.

nullValue
Object

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

formatString
String

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

Возвращаемое значение

Вновь созданный Binding.

Исключения

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

-или-

Заданный член данных не существует для источника данных.

-или-

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

Комментарии

Add Вызов метода вызывает CollectionChanged событие .

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

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

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

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue, System::String ^ formatString, IFormatProvider ^ formatInfo);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue, string formatString, IFormatProvider formatInfo);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue, string formatString, IFormatProvider? formatInfo);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string * IFormatProvider -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object, formatString As String, formatInfo As IFormatProvider) As Binding

Параметры

propertyName
String

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

dataSource
Object

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

dataMember
String

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

formattingEnabled
Boolean

Значение true для форматирования отображаемых данных, в противном случае — значение false.

updateMode
DataSourceUpdateMode

Одно из значений перечисления DataSourceUpdateMode.

nullValue
Object

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

formatString
String

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

formatInfo
IFormatProvider

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

Возвращаемое значение

Вновь созданный Binding.

Исключения

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

-или-

Заданный член данных не существует для источника данных.

-или-

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

Комментарии

Add Вызов метода вызывает CollectionChanged событие .

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