ControlBindingsCollection.Add Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Dodaje element Binding do kolekcji.

Przeciążenia

Add(Binding)	Dodaje określony Binding element do kolekcji.
Add(String, Object, String)	Binding Tworzy obiekt przy użyciu określonej nazwy właściwości kontrolki, źródła danych i elementu członkowskiego danych oraz dodaje go do kolekcji.
Add(String, Object, String, Boolean)	Tworzy powiązanie z określoną nazwą właściwości kontrolki, źródłem danych, elementem członkowskim danych i informacjami o tym, czy formatowanie jest włączone, i dodaje powiązanie do kolekcji.
Add(String, Object, String, Boolean, DataSourceUpdateMode)	Tworzy powiązanie, które wiąże określoną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych, opcjonalnie włączając formatowanie, propagowanie wartości do źródła danych na podstawie określonego ustawienia aktualizacji i dodanie powiązania do kolekcji.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Tworzy powiązanie, które wiąże określoną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych, opcjonalnie włączając formatowanie, propagując wartości do źródła danych na podstawie określonego ustawienia aktualizacji, ustawiając właściwość na określoną wartość DBNull po powrocie ze źródła danych i dodając powiązanie do kolekcji.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Tworzy powiązanie, które wiąże określoną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych, opcjonalnie włączając formatowanie za pomocą określonego ciągu formatu, propagując wartości do źródła danych na podstawie określonego ustawienia aktualizacji, ustawiając właściwość na określoną wartość DBNull po powrocie ze źródła danych i dodając powiązanie do kolekcji.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Tworzy powiązanie, które wiąże określoną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych, opcjonalnie włączając formatowanie za pomocą określonego ciągu formatu, propagując wartości do źródła danych na podstawie określonego ustawienia aktualizacji, ustawiając właściwość na określoną wartość DBNull po powrocie ze źródła danych, ustawiając określonego dostawcę formatu, i dodanie powiązania do kolekcji.

Add(Binding)

Dodaje określony Binding element do kolekcji.

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)

Parametry

binding: Binding

Element do dodania Binding .

Wyjątki

ArgumentNullException

Wartość binding ma wartość null.

ArgumentException

Właściwość kontrolki jest już powiązana z danymi.

-lub-

Element Binding nie określa prawidłowej kolumny .DataSource

Przykłady

Poniższy przykład kodu tworzy Binding wystąpienie i używa Add metody , aby dodać wystąpienie do ControlBindingsCollection kontrolki TextBox .

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

Uwagi

Właściwość DataSourceUpdateMode utworzona Binding przez to przeciążenie Add metody jest ustawiona na wartość DefaultDataSourceUpdateMode właściwości .

Zdarzenie CollectionChanged występuje po zakończeniu zmiany.

Dotyczy

Add(String, Object, String)

Binding Tworzy obiekt przy użyciu określonej nazwy właściwości kontrolki, źródła danych i elementu członkowskiego danych oraz dodaje go do kolekcji.

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

Parametry

propertyName: String

Nazwa właściwości kontrolki do powiązania.

dataSource: Object

Element Object reprezentujący źródło danych.

dataMember: String

Właściwość lub lista do powiązania.

Zwraca

Binding

Nowo utworzony element Binding.

Wyjątki

ArgumentNullException

Element binding to null.

Exception

Element propertyName jest już powiązany z danymi.

-lub-

Element dataMember nie określa prawidłowego elementu członkowskiego .dataSource

Przykłady

Poniższy przykład kodu używa Add metody , aby dodać trzy Binding obiekty do ControlBindingsCollection kontrolki TextBox . Dostęp ControlBindingsCollection do obiektu jest uzyskiwany za pośrednictwem DataBindings właściwości Control klasy .

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

Uwagi

Właściwość DataSourceUpdateMode utworzona Binding przez to przeciążenie Add metody jest ustawiona na wartość DefaultDataSourceUpdateMode właściwości .

Dodanie elementu Binding powoduje CollectionChanged wystąpienie zdarzenia.

Dotyczy

Add(String, Object, String, Boolean)

Tworzy powiązanie z określoną nazwą właściwości kontrolki, źródłem danych, elementem członkowskim danych i informacjami o tym, czy formatowanie jest włączone, i dodaje powiązanie do kolekcji.

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

Parametry

propertyName: String

Nazwa właściwości kontrolki do powiązania.

dataSource: Object

Reprezentująca Object źródło danych.

dataMember: String

Właściwość lub lista do powiązania.

formattingEnabled: Boolean

true aby sformatować wyświetlane dane; w przeciwnym razie , false.

Zwraca

Binding

Nowo utworzony element Binding.

Wyjątki

ArgumentException

Właściwość podana przez propertyName nie istnieje w kontrolce.

-lub-

Podana właściwość jest właściwością tylko do odczytu.

Exception

Jeśli formatowanie jest wyłączone, a propertyName właściwość nie jest prawidłową właściwością kontrolki ani pustym ciągiem ("").

Dotyczy

Add(String, Object, String, Boolean, DataSourceUpdateMode)

Tworzy powiązanie, które wiąże określoną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych, opcjonalnie włączając formatowanie, propagowanie wartości do źródła danych na podstawie określonego ustawienia aktualizacji i dodanie powiązania do kolekcji.

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

Parametry

propertyName: String

Nazwa właściwości kontrolki do powiązania.

dataSource: Object

Reprezentująca Object źródło danych.

dataMember: String

Właściwość lub lista do powiązania.

formattingEnabled: Boolean

true aby sformatować wyświetlane dane; w przeciwnym razie , false.

updateMode: DataSourceUpdateMode

Jedna z DataSourceUpdateMode wartości.

Zwraca

Binding

Nowo utworzony element Binding.

Wyjątki

ArgumentException

Właściwość podana przez propertyName nie istnieje w kontrolce lub jest tylko do odczytu.

-lub-

Określony element członkowski danych nie istnieje w źródle danych.

-lub-

Określone źródło danych, składowa danych lub właściwość kontrolki są skojarzone z innym powiązaniem w kolekcji.

Uwagi

Add Wywołanie metody powoduje wywołanie CollectionChanged zdarzenia.

Dotyczy

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Tworzy powiązanie, które wiąże określoną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych, opcjonalnie włączając formatowanie, propagując wartości do źródła danych na podstawie określonego ustawienia aktualizacji, ustawiając właściwość na określoną wartość DBNull po powrocie ze źródła danych i dodając powiązanie do kolekcji.

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

Parametry

propertyName: String

Nazwa właściwości kontrolki do powiązania.

dataSource: Object

Reprezentująca Object źródło danych.

dataMember: String

Właściwość lub lista do powiązania.

formattingEnabled: Boolean

true aby sformatować wyświetlane dane; w przeciwnym razie , false.

updateMode: DataSourceUpdateMode

Jedna z DataSourceUpdateMode wartości.

nullValue: Object

Gdy źródło danych ma tę wartość, właściwość powiązana jest ustawiona na DBNullwartość .

Zwraca

Binding

Nowo utworzony element Binding.

Wyjątki

ArgumentException

Właściwość podana przez propertyName nie istnieje w kontrolce lub jest tylko do odczytu.

-lub-

Określony element członkowski danych nie istnieje w źródle danych.

-lub-

Określone źródło danych, składowa danych lub właściwość kontrolki są skojarzone z innym powiązaniem w kolekcji.

Uwagi

Add Wywołanie metody powoduje wywołanie CollectionChanged zdarzenia.

Dotyczy

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Tworzy powiązanie, które wiąże określoną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych, opcjonalnie włączając formatowanie za pomocą określonego ciągu formatu, propagując wartości do źródła danych na podstawie określonego ustawienia aktualizacji, ustawiając właściwość na określoną wartość DBNull po powrocie ze źródła danych i dodając powiązanie do kolekcji.

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

Parametry

propertyName: String

Nazwa właściwości kontrolki do powiązania.

dataSource: Object

Reprezentująca Object źródło danych.

dataMember: String

Właściwość lub lista do powiązania.

formattingEnabled: Boolean

true aby sformatować wyświetlane dane; w przeciwnym razie , false.

updateMode: DataSourceUpdateMode

Jedna z DataSourceUpdateMode wartości.

nullValue: Object

Gdy źródło danych ma tę wartość, właściwość powiązana jest ustawiona na DBNullwartość .

formatString: String

Co najmniej jeden znak specyfikatora formatu wskazujący sposób wyświetlania wartości.

Zwraca

Binding

Nowo utworzony element Binding.

Wyjątki

ArgumentException

Właściwość podana przez propertyName nie istnieje w kontrolce lub jest tylko do odczytu.

-lub-

Określony element członkowski danych nie istnieje w źródle danych.

-lub-

Określone źródło danych, składowa danych lub właściwość kontrolki są skojarzone z innym powiązaniem w kolekcji.

Uwagi

Add Wywołanie metody powoduje wywołanie CollectionChanged zdarzenia.

Dotyczy

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)

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

Parametry

propertyName: String

Nazwa właściwości kontrolki do powiązania.

dataSource: Object

Reprezentująca Object źródło danych.

dataMember: String

Właściwość lub lista do powiązania.

formattingEnabled: Boolean

true aby sformatować wyświetlane dane; w przeciwnym razie , false.

updateMode: DataSourceUpdateMode

Jedna z DataSourceUpdateMode wartości.

nullValue: Object

Gdy źródło danych ma tę wartość, właściwość powiązana jest ustawiona na DBNullwartość .

formatString: String

Co najmniej jeden znak specyfikatora formatu wskazujący sposób wyświetlania wartości.

formatInfo: IFormatProvider

Implementacja w celu zastąpienia domyślnego IFormatProvider zachowania formatowania.

Zwraca

Binding

Nowo utworzony element Binding.

Wyjątki

ArgumentException

Właściwość podana przez propertyName nie istnieje w kontrolce lub jest tylko do odczytu.

-lub-

Określony element członkowski danych nie istnieje w źródle danych.

-lub-

Określone źródło danych, składowa danych lub właściwość kontrolki są skojarzone z innym powiązaniem w kolekcji.

Uwagi

Add Wywołanie metody powoduje wywołanie CollectionChanged zdarzenia.

Dotyczy

ControlBindingsCollection.Add Metoda

Definicja

Przeciążenia

Add(Binding)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

Add(String, Object, String)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Dotyczy

Add(String, Object, String, Boolean)

Parametry

Zwraca

Wyjątki

Dotyczy

Add(String, Object, String, Boolean, DataSourceUpdateMode)

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

Opinia

Dodatkowe zasoby