ControlBindingsCollection.Add 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
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
가 null인 경우
예제
다음 코드 예제에서는 instance 만들고 Binding 메서드를 Add 사용하여 컨트롤의 TextBox 에 instance 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
설명
메서드 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
바인딩할 컨트롤 속성의 이름입니다.
- dataMember
- String
바인딩할 속성 또는 목록입니다.
반환
새로 만든 Binding입니다.
예외
binding
이 null
인 경우
예제
다음 코드 예제를 사용 하 여 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
설명
메서드 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
바인딩할 컨트롤 속성의 이름입니다.
- dataMember
- String
바인딩할 속성 또는 목록입니다.
- formattingEnabled
- Boolean
표시된 데이터의 형식을 지정하려면 true
이고, 그러지 않으면 false
입니다.
반환
새로 만든 Binding입니다.
예외
형식 지정을 사용하지 않고 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
바인딩할 컨트롤 속성의 이름입니다.
- 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
바인딩할 컨트롤 속성의 이름입니다.
- dataMember
- String
바인딩할 속성 또는 목록입니다.
- formattingEnabled
- Boolean
표시된 데이터의 형식을 지정하려면 true
이고, 그러지 않으면 false
입니다.
- updateMode
- DataSourceUpdateMode
DataSourceUpdateMode 값 중 하나입니다.
반환
새로 만든 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
바인딩할 컨트롤 속성의 이름입니다.
- dataMember
- String
바인딩할 속성 또는 목록입니다.
- formattingEnabled
- Boolean
표시된 데이터의 형식을 지정하려면 true
이고, 그러지 않으면 false
입니다.
- updateMode
- DataSourceUpdateMode
DataSourceUpdateMode 값 중 하나입니다.
- 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
바인딩할 컨트롤 속성의 이름입니다.
- dataMember
- String
바인딩할 속성 또는 목록입니다.
- formattingEnabled
- Boolean
표시된 데이터의 형식을 지정하려면 true
이고, 그러지 않으면 false
입니다.
- updateMode
- DataSourceUpdateMode
DataSourceUpdateMode 값 중 하나입니다.
- formatString
- String
값을 표시할 방법을 나타내는 하나 이상의 서식 지정자 문자입니다.
- formatInfo
- IFormatProvider
기본 서식 지정 동작을 재정의하도록 구현된 IFormatProvider입니다.
반환
새로 만든 Binding입니다.
예외
propertyName
에 지정된 속성이 컨트롤에 없거나 읽기 전용인 경우
또는
지정된 데이터 멤버가 데이터 소스에 없는 경우
또는
지정한 데이터 소스, 데이터 멤버 또는 컨트롤 속성이 컬렉션의 다른 바인딩과 연결되어 있는 경우
설명
호출 된 Add 메서드를 발생 시킵니다는 CollectionChanged 이벤트입니다.
적용 대상
.NET