BindingSource.Add(Object) 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

BindingSource.cs

將現有項目加入內部清單。

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 加入內部名單。

傳回

Int32

該以零為基礎的索引 value 被加入該屬性所代表 List 的底層清單中。

實作

Add(Object)

例外狀況

InvalidOperationException

value 在類型上與底層清單中現有的項目不同。

範例

以下程式碼範例說明如何使用此 Add 方法。 要執行這個範例，將程式碼貼到 Windows 表單，然後從表單的建構子呼叫該 PopulateBindingSourceWithFonts 方法。

  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 。

內部清單必須包含同質型態。 如果該 DataSource 屬性尚未被設定，則第一個加入清單的物件定義該清單的型別。

此方法提升事件。ListChanged

另請參閱

• List
• Position
• AddNew()
• Remove(Object)
• RemoveCurrent()
• Insert(Int32, Object)