Udostępnij za pośrednictwem


ControlBindingsCollection.Add Metoda

Definicja

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

Wartość binding ma wartość null.

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

Nowo utworzony element Binding.

Wyjątki

Element binding to null.

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

Nowo utworzony element Binding.

Wyjątki

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

-lub-

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

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

Nowo utworzony element Binding.

Wyjątki

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

Nowo utworzony element Binding.

Wyjątki

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

Nowo utworzony element Binding.

Wyjątki

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)

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.

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

Nowo utworzony element Binding.

Wyjątki

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