ControlBindingsCollection.Add 메서드

정의

Binding를 컬렉션에 추가합니다.Adds a Binding to the collection.

오버로드

Add(Binding)

지정된 Binding를 컬렉션에 추가합니다.Adds the specified Binding to the collection.

Add(String, Object, String)

지정된 컨트롤 속성 이름, 데이터 소스 및 데이터 멤버를 사용하여 Binding을 만든 다음 컬렉션에 추가합니다.Creates a Binding using the specified control property name, data source, and data member, and adds it to the collection.

Add(String, Object, String, Boolean)

지정된 컨트롤 속성 이름, 데이터 소스, 데이터 멤버, 형식을 지정할 수 있는지 여부에 대한 정보 등을 사용하여 바인딩을 만든 다음 컬렉션에 바인딩을 추가합니다.Creates a binding with the specified control property name, data source, data member, and information about whether formatting is enabled, and adds the binding to the collection.

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

지정된 컨트롤 속성을 지정된 데이터 소스의 지정된 데이터 멤버에 바인딩하는 바인딩을 만들고, 선택적으로 형식 지정을 활성화하고, 지정된 업데이트 설정을 기반으로 데이터 소스에 값을 전파하고, 바인딩을 컬렉션에 추가합니다.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, and adding the binding to the collection.

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

지정된 컨트롤 속성을 지정된 데이터 소스의 지정된 데이터 멤버에 바인딩하는 바인딩을 만들고, 선택적으로 형식 지정을 활성화하고, 지정된 업데이트 설정을 기반으로 데이터 소스에 값을 전파하고, 데이터 소스에서 DBNull이 반환되면 해당 속성을 지정된 값으로 설정하고, 바인딩을 컬렉션에 추가합니다.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, and adding the binding to the collection.

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

지정된 컨트롤 속성을 지정된 데이터 소스의 지정된 데이터 멤버에 바인딩하는 바인딩을 만들고, 선택적으로 지정된 형식 문자열을 사용하여 형식 지정을 활성화하고, 지정된 업데이트 설정을 기반으로 데이터 소스에 값을 전파하고, 데이터 소스에서 DBNull이 반환되면 해당 속성을 지정된 값으로 설정하고, 바인딩을 컬렉션에 추가합니다.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, and adding the binding to the collection.

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

지정된 컨트롤 속성을 지정된 데이터 소스의 지정된 데이터 멤버에 바인딩하는 바인딩을 만들고, 선택적으로 지정된 형식 문자열을 사용하여 형식 지정을 활성화하고, 지정된 업데이트 설정을 기반으로 데이터 소스에 값을 전파하고, 데이터 소스에서 DBNull이 반환되면 해당 속성을 지정된 값으로 설정하고, 지정된 형식 공급자를 설정하고, 바인딩을 컬렉션에 추가합니다.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, setting the specified format provider, and adding the binding to the collection.

Add(Binding)

지정된 Binding를 컬렉션에 추가합니다.Adds the specified Binding to the collection.

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

매개 변수

binding
Binding

추가할 Binding입니다.The Binding to add.

예외

binding가 null인 경우The binding is null.

컨트롤 속성이 이미 데이터 바인딩 상태인 경우The control property is already data-bound.

또는-or-

BindingDataSource의 유효한 열을 지정하지 않는 경우The Binding does not specify a valid column of the DataSource.

예제

다음 코드 예제에서는 Binding 인스턴스를 사용 하 여는 Add 인스턴스를 추가 하는 방법의 ControlBindingsCollectionTextBox 컨트롤입니다.The following code example creates a Binding instance, and uses the Add method to add the instance to the ControlBindingsCollection of a TextBox control.

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 속성.The DataSourceUpdateMode property of the Binding created by this overload of the Add method is set to the value of the DefaultDataSourceUpdateMode property.

CollectionChanged 변경이 완료 되 면 이벤트가 발생 합니다.The CollectionChanged event occurs when the change is complete.

Add(String, Object, String)

지정된 컨트롤 속성 이름, 데이터 소스 및 데이터 멤버를 사용하여 Binding을 만든 다음 컬렉션에 추가합니다.Creates a Binding using the specified control property name, data source, and data member, and adds it to the collection.

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

바인딩할 컨트롤 속성의 이름입니다.The name of the control property to bind.

dataSource
Object

데이터 소스를 나타내는 Object입니다.An Object that represents the data source.

dataMember
String

바인딩할 속성 또는 목록입니다.The property or list to bind to.

반환

새로 만든 Binding입니다.The newly created Binding.

예외

bindingnull인 경우The binding is null.

propertyName이 이미 데이터 바인딩 상태인 경우The propertyName is already data-bound.

또는-or-

dataMember에서 dataSource의 올바른 멤버를 지정하지 않는 경우The dataMember doesn't specify a valid member of the dataSource.

예제

다음 코드 예제에서는 합니다 Add 3 개 추가 하는 방법 Binding 개체를 ControlBindingsCollectionTextBox 컨트롤입니다.The following code example uses the Add method to add three Binding objects to the ControlBindingsCollection of a TextBox control. ControlBindingsCollectionDataBindings 클래스의 Control 속성을 통해 액세스됩니다.The ControlBindingsCollection is accessed through the DataBindings property of the Control class.

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 속성.The DataSourceUpdateMode property of the Binding created by this overload of the Add method is set to the value of the DefaultDataSourceUpdateMode property.

추가 Binding 발생을 CollectionChanged 이벤트를 발생 합니다.Adding a Binding causes the CollectionChanged event to occur.

Add(String, Object, String, Boolean)

지정된 컨트롤 속성 이름, 데이터 소스, 데이터 멤버, 형식을 지정할 수 있는지 여부에 대한 정보 등을 사용하여 바인딩을 만든 다음 컬렉션에 바인딩을 추가합니다.Creates a binding with the specified control property name, data source, data member, and information about whether formatting is enabled, and adds the binding to the collection.

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

바인딩할 컨트롤 속성의 이름입니다.The name of the control property to bind.

dataSource
Object

데이터 소스를 나타내는 Object입니다.An Object representing the data source.

dataMember
String

바인딩할 속성 또는 목록입니다.The property or list to bind to.

formattingEnabled
Boolean

표시된 데이터의 형식을 지정하려면 true이고, 그러지 않으면 false입니다.true to format the displayed data; otherwise, false

반환

새로 만든 Binding입니다.The newly created Binding.

예외

propertyName에 지정된 속성이 컨트롤에 없는 경우The property given by propertyName does not exist on the control.

또는-or- 지정한 속성이 읽기 전용 속성인 경우The property given is a read-only property.

형식 지정을 사용하지 않고 propertyName이 올바른 컨트롤 속성도 아니고 빈 문자열("")도 아닌 경우If formatting is disabled and the propertyName is neither a valid property of a control nor an empty string ("").

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

지정된 컨트롤 속성을 지정된 데이터 소스의 지정된 데이터 멤버에 바인딩하는 바인딩을 만들고, 선택적으로 형식 지정을 활성화하고, 지정된 업데이트 설정을 기반으로 데이터 소스에 값을 전파하고, 바인딩을 컬렉션에 추가합니다.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, and adding the binding to the collection.

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

바인딩할 컨트롤 속성의 이름입니다.The name of the control property to bind.

dataSource
Object

데이터 소스를 나타내는 Object입니다.An Object representing the data source.

dataMember
String

바인딩할 속성 또는 목록입니다.The property or list to bind to.

formattingEnabled
Boolean

표시된 데이터의 형식을 지정하려면 true이고, 그러지 않으면 false입니다.true to format the displayed data; otherwise, false.

updateMode
DataSourceUpdateMode

DataSourceUpdateMode 값 중 하나입니다.One of the DataSourceUpdateMode values.

반환

새로 만든 Binding입니다.The newly created Binding.

예외

propertyName에 지정된 속성이 컨트롤에 없거나 읽기 전용인 경우The property given by propertyName does not exist on the control or is read-only.

또는-or- 지정된 데이터 멤버가 데이터 소스에 없는 경우The specified data member does not exist on the data source.

또는-or- 지정한 데이터 소스, 데이터 멤버 또는 컨트롤 속성이 컬렉션의 다른 바인딩과 연결되어 있는 경우The data source, data member, or control property specified are associated with another binding in the collection.

설명

호출 된 Add 메서드를 발생 시킵니다는 CollectionChanged 이벤트입니다.Calling the Add method raises the CollectionChanged event.

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

지정된 컨트롤 속성을 지정된 데이터 소스의 지정된 데이터 멤버에 바인딩하는 바인딩을 만들고, 선택적으로 형식 지정을 활성화하고, 지정된 업데이트 설정을 기반으로 데이터 소스에 값을 전파하고, 데이터 소스에서 DBNull이 반환되면 해당 속성을 지정된 값으로 설정하고, 바인딩을 컬렉션에 추가합니다.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, and adding the binding to the collection.

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

바인딩할 컨트롤 속성의 이름입니다.The name of the control property to bind.

dataSource
Object

데이터 소스를 나타내는 Object입니다.An Object representing the data source.

dataMember
String

바인딩할 속성 또는 목록입니다.The property or list to bind to.

formattingEnabled
Boolean

표시된 데이터의 형식을 지정하려면 true이고, 그러지 않으면 false입니다.true to format the displayed data; otherwise, false.

updateMode
DataSourceUpdateMode

DataSourceUpdateMode 값 중 하나입니다.One of the DataSourceUpdateMode values.

nullValue
Object

데이터 소스가 이 값을 가진 경우 바인딩된 속성이 DBNull로 설정됩니다.When the data source has this value, the bound property is set to DBNull.

반환

새로 만든 Binding입니다.The newly created Binding

예외

propertyName에 지정된 속성이 컨트롤에 없거나 읽기 전용인 경우The property given by propertyName does not exist on the control or is read-only.

또는-or- 지정된 데이터 멤버가 데이터 소스에 없는 경우The specified data member does not exist on the data source.

또는-or- 지정한 데이터 소스, 데이터 멤버 또는 컨트롤 속성이 컬렉션의 다른 바인딩과 연결되어 있는 경우The data source, data member, or control property specified are associated with another binding in the collection.

설명

호출 된 Add 메서드를 발생 시킵니다는 CollectionChanged 이벤트입니다.Calling the Add method raises the CollectionChanged event.

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

지정된 컨트롤 속성을 지정된 데이터 소스의 지정된 데이터 멤버에 바인딩하는 바인딩을 만들고, 선택적으로 지정된 형식 문자열을 사용하여 형식 지정을 활성화하고, 지정된 업데이트 설정을 기반으로 데이터 소스에 값을 전파하고, 데이터 소스에서 DBNull이 반환되면 해당 속성을 지정된 값으로 설정하고, 바인딩을 컬렉션에 추가합니다.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, and adding the binding to the collection.

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

바인딩할 컨트롤 속성의 이름입니다.The name of the control property to bind.

dataSource
Object

데이터 소스를 나타내는 Object입니다.An Object representing the data source.

dataMember
String

바인딩할 속성 또는 목록입니다.The property or list to bind to.

formattingEnabled
Boolean

표시된 데이터의 형식을 지정하려면 true이고, 그러지 않으면 false입니다.true to format the displayed data; otherwise, false.

updateMode
DataSourceUpdateMode

DataSourceUpdateMode 값 중 하나입니다.One of the DataSourceUpdateMode values.

nullValue
Object

데이터 소스가 이 값을 가진 경우 바인딩된 속성이 DBNull로 설정됩니다.When the data source has this value, the bound property is set to DBNull.

formatString
String

값을 표시할 방법을 나타내는 하나 이상의 서식 지정자 문자입니다.One or more format specifier characters that indicate how a value is to be displayed.

반환

새로 만든 Binding입니다.The newly created Binding

예외

propertyName에 지정된 속성이 컨트롤에 없거나 읽기 전용인 경우The property given by propertyName does not exist on the control or is read-only.

또는-or- 지정된 데이터 멤버가 데이터 소스에 없는 경우The specified data member does not exist on the data source.

또는-or- 지정한 데이터 소스, 데이터 멤버 또는 컨트롤 속성이 컬렉션의 다른 바인딩과 연결되어 있는 경우The data source, data member, or control property specified are associated with another binding in the collection.

설명

호출 된 Add 메서드를 발생 시킵니다는 CollectionChanged 이벤트입니다.Calling the Add method raises the CollectionChanged event.

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

지정된 컨트롤 속성을 지정된 데이터 소스의 지정된 데이터 멤버에 바인딩하는 바인딩을 만들고, 선택적으로 지정된 형식 문자열을 사용하여 형식 지정을 활성화하고, 지정된 업데이트 설정을 기반으로 데이터 소스에 값을 전파하고, 데이터 소스에서 DBNull이 반환되면 해당 속성을 지정된 값으로 설정하고, 지정된 형식 공급자를 설정하고, 바인딩을 컬렉션에 추가합니다.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, setting the specified format provider, and adding the binding to the collection.

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

바인딩할 컨트롤 속성의 이름입니다.The name of the control property to bind.

dataSource
Object

데이터 소스를 나타내는 Object입니다.An Object representing the data source.

dataMember
String

바인딩할 속성 또는 목록입니다.The property or list to bind to.

formattingEnabled
Boolean

표시된 데이터의 형식을 지정하려면 true이고, 그러지 않으면 false입니다.true to format the displayed data; otherwise, false.

updateMode
DataSourceUpdateMode

DataSourceUpdateMode 값 중 하나입니다.One of the DataSourceUpdateMode values.

nullValue
Object

데이터 소스가 이 값을 가진 경우 바인딩된 속성이 DBNull로 설정됩니다.When the data source has this value, the bound property is set to DBNull.

formatString
String

값을 표시할 방법을 나타내는 하나 이상의 서식 지정자 문자입니다.One or more format specifier characters that indicate how a value is to be displayed

formatInfo
IFormatProvider

기본 서식 지정 동작을 재정의하도록 구현된 IFormatProvider입니다.An implementation of IFormatProvider to override default formatting behavior.

반환

새로 만든 Binding입니다.The newly created Binding.

예외

propertyName에 지정된 속성이 컨트롤에 없거나 읽기 전용인 경우The property given by propertyName does not exist on the control or is read-only.

또는-or- 지정된 데이터 멤버가 데이터 소스에 없는 경우The specified data member does not exist on the data source.

또는-or- 지정한 데이터 소스, 데이터 멤버 또는 컨트롤 속성이 컬렉션의 다른 바인딩과 연결되어 있는 경우The data source, data member, or control property specified are associated with another binding in the collection.

설명

호출 된 Add 메서드를 발생 시킵니다는 CollectionChanged 이벤트입니다.Calling the Add method raises the CollectionChanged event.

적용 대상