BindingSource.Add(Object) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt der internen Liste ein vorhandenes Element hinzu.

public:
 virtual int Add(System::Object ^ value);

public virtual int Add (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

Parameter

value: Object

Ein Object, das der internen Liste hinzugefügt werden soll.

Gibt zurück

Int32

Der nullbasierte Index, an dem der durch die List-Eigenschaft dargestellten zugrunde liegenden Liste value hinzugefügt wurde.

Implementiert

Add(Object)

Ausnahmen

InvalidOperationException

value unterscheidet sich im Typ von den vorhandenen Elementen in der zugrunde liegenden Liste.

Beispiele

Im folgenden Codebeispiel wird beschrieben, wie die Add -Methode verwendet wird. Fügen Sie zum Ausführen dieses Beispiels den Code in eine Windows Form-Datei ein, und rufen Sie die PopulateBindingSourceWithFonts -Methode aus dem Konstruktor des Formulars auf.

  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

Hinweise

Die Add -Methode verweist auf den Aufruf auf die -Methode der zugrunde liegenden Liste Add .

Die interne Liste muss homogene Typen enthalten. Wenn die DataSource Eigenschaft noch nicht festgelegt wurde, definiert das erste Der Liste hinzugefügte Objekt den Typ für die Liste.

Diese Methode löst das ListChanged Ereignis aus.

Gilt für: