ControlBindingsCollection.Add Метод

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Добавляет коллекцию 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)

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Добавляет указанный 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 объект.

Исключения

ArgumentNullException

Значение binding null.

ArgumentException

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

–или–

Недопустимый Binding столбец столбца DataSource.

Примеры

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

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

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

Add(String, Object, String)

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Создает указанное 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

Только что созданный Binding.

Исключения

ArgumentNullException

Значение параметра binding — null.

Exception

Он propertyName уже привязан к данным.

–или–

Не dataMember указывает допустимый элемент dataSourceэлемента .

Примеры

В следующем примере кода метод используется Add для добавления трех Binding объектов в ControlBindingsCollection TextBox элемент управления. Доступ 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

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

Add(String, Object, String, Boolean)

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

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

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

Только что созданный Binding.

Исключения

ArgumentException

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

–или–

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

Exception

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

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

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

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

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

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

Только что созданный Binding.

Исключения

ArgumentException

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

–или–

Указанный элемент данных не существует в источнике данных.

–или–

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

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

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

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

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

Только что созданный Binding.

Исключения

ArgumentException

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

–или–

Указанный элемент данных не существует в источнике данных.

–или–

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

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

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

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

Только что созданный Binding.

Исключения

ArgumentException

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

–или–

Указанный элемент данных не существует в источнике данных.

–или–

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

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

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

Исходный код:: ControlBindingsCollection.cs

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

Только что созданный Binding.

Исключения

ArgumentException

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

–или–

Указанный элемент данных не существует в источнике данных.

–или–

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

Обратная связь

Были ли сведения на этой странице полезными?

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

ControlBindingsCollection.Add Метод

Определение

Перегрузки

Add(Binding)

Параметры

Исключения

Примеры

Комментарии

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

Add(String, Object, String)

Параметры

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

Исключения

Примеры

Комментарии

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

Add(String, Object, String, Boolean)

Параметры

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

Исключения

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

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

Параметры

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

Исключения

Комментарии

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

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

Параметры

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

Исключения

Комментарии

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

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

Параметры

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

Исключения

Комментарии

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

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

Параметры

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

Исключения

Комментарии

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

Обратная связь