BindingSource.Add(Object) 方法

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll

將現有項目加入內部清單中。Adds an existing item to the internal list.

public:
 virtual int Add(System::Object ^ value);
public virtual int Add (object value);
abstract member Add : obj -> int
override this.Add : obj -> int
Public Overridable Function Add (value As Object) As Integer

參數

value
Object

要加入內部清單中的 Object。An Object to be added to the internal list.

傳回

Int32

以零起始的索引，value 會在其上加入由 List 屬性所表示的基礎清單。The zero-based index at which value was added to the underlying list represented by the List property.

實作

Add(Object)

例外狀況

InvalidOperationException

value，其型別與基礎清單中現有項目的型別不同。value differs in type from the existing items in the underlying list.

範例

下列程式碼範例示範如何使用 Add 方法。The following code example how to use the Add method. 若要執行此範例，請將程式碼貼到 Windows Form 中，並 PopulateBindingSourceWithFonts 從表單的函式呼叫該方法。To run this example, paste the code into a Windows Form, and call the PopulateBindingSourceWithFonts method from the form's constructor.

  public BindingSource bindingSource1 = new BindingSource();
  TextBox box1 = new TextBox();

  private void PopulateBindingSourceWithFonts()
  {
      bindingSource1.CurrentChanged += new EventHandler(bindingSource1_CurrentChanged);
      bindingSource1.Add(new Font(FontFamily.Families[2], 8.0F));
      bindingSource1.Add(new Font(FontFamily.Families[4], 9.0F));
      bindingSource1.Add(new Font(FontFamily.Families[6], 10.0F));
      bindingSource1.Add(new Font(FontFamily.Families[8], 11.0F));
      bindingSource1.Add(new Font(FontFamily.Families[10], 12.0F));
      DataGridView view1 = new DataGridView();
      view1.DataSource = bindingSource1;
      view1.AutoGenerateColumns = true;
      view1.Dock = DockStyle.Top;
      this.Controls.Add(view1);
      box1.Dock = DockStyle.Bottom;
      box1.Text = "Sample Text";
      this.Controls.Add(box1);
      box1.DataBindings.Add("Text", bindingSource1, "Name");
      view1.Columns[7].DisplayIndex = 0;
  }

  void bindingSource1_CurrentChanged(object sender, EventArgs e)
  {
      box1.Font = (Font)bindingSource1.Current;
  }

 Private WithEvents bindingSource1 As New BindingSource()
 Private box1 As New TextBox()

 
 Private Sub PopulateBindingSourceWithFonts()
   
     bindingSource1.Add(New Font(FontFamily.Families(2), 8.0F))
     bindingSource1.Add(New Font(FontFamily.Families(4), 9.0F))
     bindingSource1.Add(New Font(FontFamily.Families(6), 10.0F))
     bindingSource1.Add(New Font(FontFamily.Families(8), 11.0F))
     bindingSource1.Add(New Font(FontFamily.Families(10), 12.0F))
     Dim view1 As New DataGridView()
     view1.DataSource = bindingSource1
     view1.AutoGenerateColumns = True
     view1.Dock = DockStyle.Top
     Me.Controls.Add(view1)
     box1.Dock = DockStyle.Bottom
     box1.Text = "Sample Text"
     Me.Controls.Add(box1)
     view1.Columns("Name").DisplayIndex = 0
     box1.DataBindings.Add("Text", bindingSource1, "Name")
     
 End Sub
  
 Sub bindingSource1_CurrentChanged(ByVal sender As Object, ByVal e As EventArgs) _
     Handles bindingSource1.CurrentChanged
     box1.Font = CType(bindingSource1.Current, Font)
 End Sub

備註

Add方法會參考基礎清單方法的呼叫 Add 。The Add method refers the call to the underlying list's Add method.

內部清單必須包含同質類型。The internal list must contain homogenous types. 如果 DataSource 尚未設定屬性，則新增至清單的第一個物件會定義清單的類型。If the DataSource property has not already been set, then the first object added to the list defines the type for the list.

這個方法會引發 ListChanged 事件。This method raises the ListChanged event.

適用於

另請參閱