BindingContext.Item[Object] BindingContext.Item[Object] BindingContext.Item[Object] BindingContext.Item[Object] Property

정의

오버로드

Item[Object, String] Item[Object, String] Item[Object, String] Item[Object, String]

지정된 데이터 소스 및 데이터 멤버와 관련된 BindingManagerBase를 가져옵니다.Gets a BindingManagerBase that is associated with the specified data source and data member.

Item[Object] Item[Object] Item[Object] Item[Object]

지정된 데이터 소스와 연결된 BindingManagerBase를 가져옵니다.Gets the BindingManagerBase that is associated with the specified data source.

Item[Object, String] Item[Object, String] Item[Object, String] Item[Object, String]

지정된 데이터 소스 및 데이터 멤버와 관련된 BindingManagerBase를 가져옵니다.Gets a BindingManagerBase that is associated with the specified data source and data member.

public:
 property System::Windows::Forms::BindingManagerBase ^ default[System::Object ^, System::String ^] { System::Windows::Forms::BindingManagerBase ^ get(System::Object ^ dataSource, System::String ^ dataMember); };
public System.Windows.Forms.BindingManagerBase this[object dataSource, string dataMember] { get; }
member this.Item(obj * string) : System.Windows.Forms.BindingManagerBase
Default Public ReadOnly Property Item(dataSource As Object, dataMember As String) As BindingManagerBase

매개 변수

dataSource
Object Object Object Object

특정 BindingManagerBase와 관련된 데이터 소스입니다.The data source associated with a particular BindingManagerBase.

dataMember
String String String String

특정 BindingManagerBase에 대한 정보가 포함된 탐색 경로입니다.A navigation path containing the information that resolves to a specific BindingManagerBase.

속성 값

지정된 데이터 소스 및 데이터 멤버에 대한 BindingManagerBase입니다.The BindingManagerBase for the specified data source and data member.

예외

데이터 소스에 지정한 dataMember가 없는 경우The specified dataMember does not exist within the data source.

예제

다음 코드 예제를 사용 하는 방법에 설명 합니다 Item[Object] 검색할는 BindingManagerBase 특정 바인딩에 대 한 합니다.The following code example demonstrates how to use the Item[Object] to retrieve the BindingManagerBase for a particular binding. 또한 처리 하는 방법을 보여 줍니다 합니다 BindingComplete 에 대 한 이벤트를 BindingManagerBase 동일한 데이터 소스에 바인딩된 여러 컨트롤의 컨트롤 값 중 하나가 변경 되 면 들이 동기화 된 상태로 유지 되도록 합니다.It also shows how to handle the BindingComplete event for the BindingManagerBase to ensure multiple controls bound to the same data source remain synchronized when one of the control values is changed. 이 예제를 실행 하려면 호출을 Windows Form에 코드를 붙여넣은 합니다 InitializeControlsAndData 폼의 생성자에서 메서드 또는 Load 이벤트 처리 메서드.To run this example, paste the code into a Windows Form and call the InitializeControlsAndData method from the form's constructor or Load event-handling method.

private void InitializeControlsAndData()
{
    // Initialize the controls and set location, size and 
    // other basic properties.
    this.dataGridView1 = new DataGridView();
    
    this.textBox1 = new TextBox();
    this.textBox2 = new TextBox();
    this.dataGridView1.ColumnHeadersHeightSizeMode =
        DataGridViewColumnHeadersHeightSizeMode.AutoSize;
    this.dataGridView1.Dock = DockStyle.Top;
    this.dataGridView1.Location = new Point(0, 0);
    this.dataGridView1.Size = new Size(292, 150);
    this.textBox1.Location = new Point(132, 156);
    this.textBox1.Size = new Size(100, 20);
    this.textBox2.Location = new Point(12, 156);
    this.textBox2.Size = new Size(100, 20);
    this.ClientSize = new Size(292, 266);
    this.Controls.Add(this.textBox2);
    this.Controls.Add(this.textBox1);
    this.Controls.Add(this.dataGridView1);

    // Declare the DataSet and add a table and column.
    DataSet set1 = new DataSet();
    set1.Tables.Add("Menu");
    set1.Tables[0].Columns.Add("Beverages");

    // Add some rows to the table.
    set1.Tables[0].Rows.Add("coffee");
    set1.Tables[0].Rows.Add("tea");
    set1.Tables[0].Rows.Add("hot chocolate");
    set1.Tables[0].Rows.Add("milk");
    set1.Tables[0].Rows.Add("orange juice");

    
    // Add the control data bindings.
    dataGridView1.DataSource = set1;
    dataGridView1.DataMember = "Menu";
    textBox1.DataBindings.Add("Text", set1,
        "Menu.Beverages", true, DataSourceUpdateMode.OnPropertyChanged);
    textBox2.DataBindings.Add("Text", set1,
        "Menu.Beverages", true, DataSourceUpdateMode.OnPropertyChanged);

    BindingManagerBase bmb = this.BindingContext[set1, "Menu"];
    bmb.BindingComplete += new BindingCompleteEventHandler(bmb_BindingComplete);
  
}

private void bmb_BindingComplete(object sender, BindingCompleteEventArgs e)
{
    // Check if the data source has been updated, and that no error has occurred.
    if (e.BindingCompleteContext ==
        BindingCompleteContext.DataSourceUpdate && e.Exception == null)

        // If not, end the current edit.
        e.Binding.BindingManagerBase.EndCurrentEdit(); ;
}
Dim WithEvents bmb As BindingManagerBase

Private Sub InitializeControlsAndData() 
    ' Initialize the controls and set location, size and 
    ' other basic properties.
    Me.dataGridView1 = New DataGridView()
    
    Me.textBox1 = New TextBox()
    Me.textBox2 = New TextBox()
    Me.dataGridView1.ColumnHeadersHeightSizeMode = _
        DataGridViewColumnHeadersHeightSizeMode.AutoSize
    Me.dataGridView1.Dock = DockStyle.Top
    Me.dataGridView1.Location = New Point(0, 0)
    Me.dataGridView1.Size = New Size(292, 150)
    Me.textBox1.Location = New Point(132, 156)
    Me.textBox1.Size = New Size(100, 20)
    Me.textBox2.Location = New Point(12, 156)
    Me.textBox2.Size = New Size(100, 20)
    Me.ClientSize = New Size(292, 266)
    Me.Controls.Add(Me.textBox2)
    Me.Controls.Add(Me.textBox1)
    Me.Controls.Add(Me.dataGridView1)
    
    ' Declare the DataSet and add a table and column.
    Dim set1 As New DataSet()
    set1.Tables.Add("Menu")
    set1.Tables(0).Columns.Add("Beverages")
    
    ' Add some rows to the table.
    set1.Tables(0).Rows.Add("coffee")
    set1.Tables(0).Rows.Add("tea")
    set1.Tables(0).Rows.Add("hot chocolate")
    set1.Tables(0).Rows.Add("milk")
    set1.Tables(0).Rows.Add("orange juice")

    ' Add the control data bindings.
    dataGridView1.DataSource = set1
    dataGridView1.DataMember = "Menu"
    textBox1.DataBindings.Add("Text", set1, "Menu.Beverages", _
        True, DataSourceUpdateMode.OnPropertyChanged)
    textBox2.DataBindings.Add("Text", set1, "Menu.Beverages", _
        True, DataSourceUpdateMode.OnPropertyChanged)

    ' Get the BindingManagerBase for this binding.
    bmb = Me.BindingContext(set1, "Menu")

End Sub

Private Sub bmb_BindingComplete(ByVal sender As Object, ByVal e As BindingCompleteEventArgs) _
    Handles bmb.BindingComplete

    ' Check if the data source has been updated, and that no error has occurred.
    If e.BindingCompleteContext = BindingCompleteContext.DataSourceUpdate _
        AndAlso e.Exception Is Nothing Then

        ' If not, end the current edit.
        e.Binding.BindingManagerBase.EndCurrentEdit()
    End If
End Sub

설명

이 오버 로드 될 때 사용 합니다 BindingManagerBase 집합을 관리 Binding 데이터 소스는 여러 개체를 포함 하는 개체입니다.Use this overload when the BindingManagerBase manages a set of Binding objects for which the data source contains multiple objects. 예를 들어, 한 DataSet 여러 포함할 수 있습니다 DataTable 하 여 연결 된 개체 DataRelation 개체.For example, a DataSet can contain several DataTable objects linked by DataRelation objects. 이러한 경우 탐색 경로가 사용 하도록 설정 하려면 필요 합니다 BindingContext 올바른 반환할 BindingManagerBase합니다.In such a case, the navigation path is required to enable the BindingContext to return the correct BindingManagerBase.

참고

Item[Object] 속성은 항상 반환을 BindingManagerBase경우는 dataMember 매개 변수는 유효 합니다.The Item[Object] property will always return a BindingManagerBase, when the dataMember parameter is valid. 반환 하지 것입니다 null합니다.It will never return null.

참조 된 Binding 컨트롤을 데이터 소스에 바인딩하는 방법에 대 한 정보 및 가능한 데이터 원본 목록은 클래스.See the Binding class for a list of possible data sources and for information about creating bindings between controls and data sources.

경우 원하는 BindingManagerBase 목록 관리 탐색 경로 목록을 끝나야 합니다.If the desired BindingManagerBase manages a list, the navigation path must also end with a list. 예를 들어 다음 C# 코드를 바인딩하는 TextBox orders 테이블에 주문 날짜를 제어 합니다.For example, the following C# code binds a TextBox control to the order date in a table of orders. 탐색 경로 포함 된 TableName, RelationName, 및 ColumnName합니다.The navigation path includes the TableName, the RelationName, and the ColumnName. 그러나 합니다 BindingManagerBase 만 사용 하 여 검색 해야 합니다 TableNameRelationName (로 확인 되는 목록).However, the BindingManagerBase must be retrieved using only the TableName and RelationName (which resolves to a list).

// The navigation path for a Binding ends with a property.  
textBox1.DataBindings.Add  
("Text", dataSet1, "Customers.custToOrders.OrderDate");  
// The navigation path for the BindingManagerBase ends with a list.  
BindingManagerBase bmOrders = this.BindingContext  
[dataSet1, "Customers.custToOrders"];  

반환 하는 경우는 BindingManagerBase, 동일한 데이터 원본으로 사용 해야는 Binding 만 탐색 경로 수정 합니다.When returning a BindingManagerBase, you should use the same data source as the Binding and modify only the navigation path.

사용 합니다 Contains 여부를 확인 하는 메서드 원하는 BindingManagerBase 이미 있습니다.Use the Contains method to determine if the desired BindingManagerBase already exists.

추가 정보

Item[Object] Item[Object] Item[Object] Item[Object]

지정된 데이터 소스와 연결된 BindingManagerBase를 가져옵니다.Gets the BindingManagerBase that is associated with the specified data source.

public:
 property System::Windows::Forms::BindingManagerBase ^ default[System::Object ^] { System::Windows::Forms::BindingManagerBase ^ get(System::Object ^ dataSource); };
public System.Windows.Forms.BindingManagerBase this[object dataSource] { get; }
member this.Item(obj) : System.Windows.Forms.BindingManagerBase
Default Public ReadOnly Property Item(dataSource As Object) As BindingManagerBase

매개 변수

dataSource
Object Object Object Object

특정 BindingManagerBase와 관련된 데이터 소스입니다.The data source associated with a particular BindingManagerBase.

속성 값

지정된 데이터 소스에 대한 BindingManagerBase입니다.A BindingManagerBase for the specified data source.

예제

다음 코드 예제에서는 3 개를 반환 합니다 BindingManagerBase 개체:에 대 한는 DataView하나씩에 대 한는 ArrayList, 및를 DataSourceBinding 에 속하는 TextBox 컨트롤입니다.The following code example returns three BindingManagerBase objects: one for a DataView, one for an ArrayList, and one for the DataSource of a Binding that belongs to a TextBox control.

void ReturnBindingManagerBase()
{
   
   // Get the BindingManagerBase for a DataView. 
   BindingManagerBase^ bmCustomers = this->BindingContext[ myDataView ];
   
   /* Get the BindingManagerBase for an ArrayList. */
   BindingManagerBase^ bmOrders = this->BindingContext[ myArrayList ];
   
   // Get the BindingManagerBase for a TextBox control.
   BindingManagerBase^ baseArray = this->BindingContext[ textBox1->DataBindings[ nullptr ]->DataSource ];
}

private void ReturnBindingManagerBase()
{
   // Get the BindingManagerBase for a DataView. 
   BindingManagerBase bmCustomers = 
   this.BindingContext [myDataView];

   /* Get the BindingManagerBase for an ArrayList. */ 
   BindingManagerBase bmOrders = 
   this.BindingContext[myArrayList];

   // Get the BindingManagerBase for a TextBox control.
   BindingManagerBase baseArray = 
   this.BindingContext[textBox1.DataBindings[0].DataSource];
}

Private Sub ReturnBindingManagerBase()
   ' Get the BindingManagerBase for a DataView. 
   Dim bmCustomers As BindingManagerBase = _
      Me.BindingContext(myDataView)

   ' Get the BindingManagerBase for an ArrayList.
   Dim bmOrders As BindingManagerBase = _
      Me.BindingContext(myArrayList)

   ' Get the BindingManagerBase for a TextBox control.
   Dim baseArray As BindingManagerBase = _
      Me.BindingContext(Text1.DataBindings(0).DataSource)
End Sub

설명

이 오버 로드를 사용 합니다 BindingManagerBase 원하는, 탐색 경로 사용할 필요가 없습니다.Use this overload if the BindingManagerBase you want does not require a navigation path. 예를 들어 경우는 BindingManagerBase 집합을 관리 Binding 사용 하는 개체를 ArrayList 또는 DataTableDataSource, 탐색 경로가 필요 없습니다.For example, if the BindingManagerBase manages a set of Binding objects that use an ArrayList or DataTable as the DataSource, no navigation path is required.

참고

Item[Object] 속성은 항상 반환 된 BindingManagerBase, 않으며 반환 하지 null합니다.The Item[Object] property will always return a BindingManagerBase, and never return null.

참조 된 Binding 컨트롤을 데이터 소스에 바인딩하는 방법에 대 한 정보 및 가능한 데이터 원본 목록은 클래스.See the Binding class for a list of possible data sources and for information about creating bindings between controls and data sources.

추가 정보

적용 대상