ControlBindingsCollection.Add Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Dodaje element Binding do kolekcji.

Przeciążenia

Nazwa	Opis
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, propagując wartości do źródła danych na podstawie określonego ustawienia aktualizacji i dodając powiązanie 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ść po DBNull 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 przy użyciu 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ść po DBNull 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ść po DBNull powrocie ze źródła danych, ustawiając określonego dostawcę formatu, i dodanie powiązania do kolekcji.

Add(Binding)

Źródło:

ControlBindingsCollection.cs

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

Parametr 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ść DataSourceUpdateModeBinding utworzona przez to przeciążenie Add metody jest ustawiona na wartość DefaultDataSourceUpdateMode właściwości .

Zdarzenie CollectionChanged występuje po zakończeniu zmiany.

Add(String, Object, String)

Źródło:

ControlBindingsCollection.cs

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);

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, która ma być powiązana.

dataSource

Object

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

dataMember

String

Właściwość lub lista, z która ma być powiązana.

Zwraca

Binding

Nowo utworzony element Binding.

Wyjątki

ArgumentNullException

Wartość 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 Control jest uzyskiwany za pośrednictwem DataBindings właściwości 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ść DataSourceUpdateModeBinding utworzona przez to przeciążenie Add metody jest ustawiona na wartość DefaultDataSourceUpdateMode właściwości .

Dodanie elementu Binding powoduje CollectionChanged wystąpienie zdarzenia.

Add(String, Object, String, Boolean)

Źródło:

ControlBindingsCollection.cs

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);

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, która ma być powiązana.

dataSource

Object

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

dataMember

String

Właściwość lub lista, z która ma być powiązana.

formattingEnabled

Boolean

true w celu sformatowania wyświetlanych danych; 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 ("").

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

Źródło:

ControlBindingsCollection.cs

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 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);

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, która ma być powiązana.

dataSource

Object

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

dataMember

String

Właściwość lub lista, z która ma być powiązana.

formattingEnabled

Boolean

true w celu sformatowania wyświetlanych danych; w przeciwnym razie, false.

updateMode

DataSourceUpdateMode

DataSourceUpdateMode Jedna z 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.

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

Źródło:

ControlBindingsCollection.cs

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ść po DBNull 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);

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, która ma być powiązana.

dataSource

Object

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

dataMember

String

Właściwość lub lista, z która ma być powiązana.

formattingEnabled

Boolean

true w celu sformatowania wyświetlanych danych; w przeciwnym razie, false.

updateMode

DataSourceUpdateMode

DataSourceUpdateMode Jedna z 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.

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

Źródło:

ControlBindingsCollection.cs

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 przy użyciu 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ść po DBNull 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);

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, która ma być powiązana.

dataSource

Object

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

dataMember

String

Właściwość lub lista, z która ma być powiązana.

formattingEnabled

Boolean

true w celu sformatowania wyświetlanych danych; w przeciwnym razie, false.

updateMode

DataSourceUpdateMode

DataSourceUpdateMode Jedna z 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.

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

Źródło:

ControlBindingsCollection.cs

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ść po DBNull powrocie ze źródła danych, ustawiając określonego dostawcę formatu, 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, 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);

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, która ma być powiązana.

dataSource

Object

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

dataMember

String

Właściwość lub lista, z która ma być powiązana.

formattingEnabled

Boolean

true w celu sformatowania wyświetlanych danych; w przeciwnym razie, false.

updateMode

DataSourceUpdateMode

DataSourceUpdateMode Jedna z 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.