ControlBindingsCollection.Add Metode

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Binding Menambahkan ke koleksi.

Overload

Add(Binding)	Menambahkan yang ditentukan Binding ke koleksi.
Add(String, Object, String)	Binding Membuat menggunakan nama properti kontrol, sumber data, dan anggota data yang ditentukan, dan menambahkannya ke koleksi.
Add(String, Object, String, Boolean)	Membuat pengikatan dengan nama properti kontrol, sumber data, anggota data, dan informasi yang ditentukan tentang apakah pemformatan diaktifkan, dan menambahkan pengikatan ke koleksi.
Add(String, Object, String, Boolean, DataSourceUpdateMode)	Membuat pengikatan yang mengikat properti kontrol yang ditentukan ke anggota data tertentu dari sumber data yang ditentukan, secara opsional mengaktifkan pemformatan, menyebarkan nilai ke sumber data berdasarkan pengaturan pembaruan yang ditentukan, dan menambahkan pengikatan ke koleksi.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Membuat pengikatan yang mengikat properti kontrol yang ditentukan ke anggota data tertentu dari sumber data yang ditentukan, secara opsional mengaktifkan pemformatan, menyebarkan nilai ke sumber data berdasarkan pengaturan pembaruan yang ditentukan, mengatur properti ke nilai yang ditentukan saat DBNull dikembalikan dari sumber data, dan menambahkan pengikatan ke koleksi.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Membuat pengikatan yang mengikat properti kontrol yang ditentukan ke anggota data yang ditentukan dari sumber data yang ditentukan, secara opsional mengaktifkan pemformatan dengan string format yang ditentukan, menyebarkan nilai ke sumber data berdasarkan pengaturan pembaruan yang ditentukan, mengatur properti ke nilai yang ditentukan saat DBNull dikembalikan dari sumber data, dan menambahkan pengikatan ke koleksi.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Membuat pengikatan yang mengikat properti kontrol yang ditentukan ke anggota data tertentu dari sumber data yang ditentukan, secara opsional mengaktifkan pemformatan dengan string format yang ditentukan, menyebarkan nilai ke sumber data berdasarkan pengaturan pembaruan yang ditentukan, mengatur properti ke nilai yang ditentukan saat DBNull dikembalikan dari sumber data, mengatur penyedia format yang ditentukan, dan menambahkan pengikatan ke koleksi.

Add(Binding)

Menambahkan yang ditentukan Binding ke koleksi.

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)

Parameter

binding: Binding

yang Binding akan ditambahkan.

Pengecualian

ArgumentNullException

adalah binding null.

ArgumentException

Properti kontrol sudah terikat data.

-atau-

Binding tidak menentukan kolom yang valid dari DataSource.

Contoh

Contoh kode berikut membuat instans Binding , dan menggunakan metode untuk menambahkan instans Add ke ControlBindingsCollection TextBox kontrol.

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

Keterangan

DataSourceUpdateMode Properti dari yang Binding dibuat oleh kelebihan metode Add ini diatur ke nilai DefaultDataSourceUpdateMode properti .

Peristiwa CollectionChanged terjadi ketika perubahan selesai.

Berlaku untuk

Add(String, Object, String)

Binding Membuat menggunakan nama properti kontrol, sumber data, dan anggota data yang ditentukan, dan menambahkannya ke koleksi.

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

Parameter

propertyName: String

Nama properti kontrol yang akan diikat.

dataSource: Object

Yang Object mewakili sumber data.

dataMember: String

Properti atau daftar yang akan diikat.

Mengembalikan

Binding

Yang baru dibuat Binding.

Pengecualian

ArgumentNullException

binding adalah null.

Exception

propertyName sudah terikat data.

-atau-

dataMember tidak menentukan anggota yang valid dari dataSource.

Contoh

Contoh kode berikut menggunakan Add metode untuk menambahkan tiga Binding objek ke ControlBindingsCollection kontrol TextBox . ControlBindingsCollection diakses melalui DataBindings properti Control kelas .

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

Keterangan

DataSourceUpdateMode Properti dari yang Binding dibuat oleh kelebihan metode Add ini diatur ke nilai DefaultDataSourceUpdateMode properti .

Menambahkan penyebab Binding terjadinya CollectionChanged peristiwa.

Berlaku untuk

Add(String, Object, String, Boolean)

Membuat pengikatan dengan nama properti kontrol, sumber data, anggota data, dan informasi yang ditentukan tentang apakah pemformatan diaktifkan, dan menambahkan pengikatan ke koleksi.

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

Parameter

propertyName: String

Nama properti kontrol yang akan diikat.

dataSource: Object

Yang Object mewakili sumber data.

dataMember: String

Properti atau daftar yang akan diikat.

formattingEnabled: Boolean

true untuk memformat data yang ditampilkan; jika tidak, false.

Mengembalikan

Binding

Yang baru dibuat Binding.

Pengecualian

ArgumentException

Properti yang diberikan oleh propertyName tidak ada pada kontrol.

-atau-

Properti yang diberikan adalah properti baca-saja.

Exception

Jika pemformatan dinonaktifkan dan propertyName bukan properti kontrol yang valid atau string kosong ("").

Berlaku untuk

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

Membuat pengikatan yang mengikat properti kontrol yang ditentukan ke anggota data tertentu dari sumber data yang ditentukan, secara opsional mengaktifkan pemformatan, menyebarkan nilai ke sumber data berdasarkan pengaturan pembaruan yang ditentukan, dan menambahkan pengikatan ke koleksi.

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

Parameter

propertyName: String

Nama properti kontrol yang akan diikat.

dataSource: Object

Yang Object mewakili sumber data.

dataMember: String

Properti atau daftar yang akan diikat.

formattingEnabled: Boolean

true untuk memformat data yang ditampilkan; jika tidak, false.

updateMode: DataSourceUpdateMode

Salah DataSourceUpdateMode satu nilai.

Mengembalikan

Binding

Yang baru dibuat Binding.

Pengecualian

ArgumentException

Properti yang diberikan oleh propertyName tidak ada pada kontrol atau baca-saja.

-atau-

Anggota data yang ditentukan tidak ada di sumber data.

-atau-

Sumber data, anggota data, atau properti kontrol yang ditentukan dikaitkan dengan pengikatan lain dalam koleksi.

Keterangan

Memanggil Add metode akan meningkatkan CollectionChanged peristiwa.

Berlaku untuk

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

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

Parameter

propertyName: String

Nama properti kontrol yang akan diikat.

dataSource: Object

Yang Object mewakili sumber data.

dataMember: String

Properti atau daftar yang akan diikat.

formattingEnabled: Boolean

true untuk memformat data yang ditampilkan; jika tidak, false.

updateMode: DataSourceUpdateMode

Salah DataSourceUpdateMode satu nilai.

nullValue: Object

Ketika sumber data memiliki nilai ini, properti terikat diatur ke DBNull.

Mengembalikan

Binding

Yang baru dibuat Binding.

Pengecualian

ArgumentException

Properti yang diberikan oleh propertyName tidak ada pada kontrol atau baca-saja.

-atau-

Anggota data yang ditentukan tidak ada di sumber data.

-atau-

Sumber data, anggota data, atau properti kontrol yang ditentukan dikaitkan dengan pengikatan lain dalam koleksi.

Keterangan

Memanggil Add metode akan meningkatkan CollectionChanged peristiwa.

Berlaku untuk

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

Membuat pengikatan yang mengikat properti kontrol yang ditentukan ke anggota data yang ditentukan dari sumber data yang ditentukan, secara opsional mengaktifkan pemformatan dengan string format yang ditentukan, menyebarkan nilai ke sumber data berdasarkan pengaturan pembaruan yang ditentukan, mengatur properti ke nilai yang ditentukan saat DBNull dikembalikan dari sumber data, dan menambahkan pengikatan ke koleksi.

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

Parameter

propertyName: String

Nama properti kontrol yang akan diikat.

dataSource: Object

Yang Object mewakili sumber data.

dataMember: String

Properti atau daftar yang akan diikat.

formattingEnabled: Boolean

true untuk memformat data yang ditampilkan; jika tidak, false.

updateMode: DataSourceUpdateMode

Salah DataSourceUpdateMode satu nilai.

nullValue: Object

Ketika sumber data memiliki nilai ini, properti terikat diatur ke DBNull.

formatString: String

Satu atau beberapa karakter penentu format yang menunjukkan bagaimana nilai akan ditampilkan.

Mengembalikan

Binding

Yang baru dibuat Binding.

Pengecualian

ArgumentException

Properti yang diberikan oleh propertyName tidak ada pada kontrol atau baca-saja.

-atau-

Anggota data yang ditentukan tidak ada di sumber data.

-atau-

Sumber data, anggota data, atau properti kontrol yang ditentukan dikaitkan dengan pengikatan lain dalam koleksi.

Keterangan

Memanggil Add metode akan meningkatkan CollectionChanged peristiwa.

Berlaku untuk

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

Membuat pengikatan yang mengikat properti kontrol yang ditentukan ke anggota data tertentu dari sumber data yang ditentukan, secara opsional mengaktifkan pemformatan dengan string format yang ditentukan, menyebarkan nilai ke sumber data berdasarkan pengaturan pembaruan yang ditentukan, mengatur properti ke nilai yang ditentukan saat DBNull dikembalikan dari sumber data, mengatur penyedia format yang ditentukan, dan menambahkan pengikatan ke koleksi.

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

Parameter

propertyName: String

Nama properti kontrol yang akan diikat.

dataSource: Object

Yang Object mewakili sumber data.

dataMember: String

Properti atau daftar yang akan diikat.

formattingEnabled: Boolean

true untuk memformat data yang ditampilkan; jika tidak, false.

updateMode: DataSourceUpdateMode

Salah DataSourceUpdateMode satu nilai.

nullValue: Object

Ketika sumber data memiliki nilai ini, properti terikat diatur ke DBNull.

formatString: String

Satu atau beberapa karakter penentu format yang menunjukkan bagaimana nilai akan ditampilkan.

formatInfo: IFormatProvider

Implementasi IFormatProvider untuk mengambil alih perilaku pemformatan default.

Mengembalikan

Binding

Yang baru dibuat Binding.

Pengecualian

ArgumentException

Properti yang diberikan oleh propertyName tidak ada pada kontrol atau baca-saja.

-atau-

Anggota data yang ditentukan tidak ada di sumber data.

-atau-

Sumber data, anggota data, atau properti kontrol yang ditentukan dikaitkan dengan pengikatan lain dalam koleksi.

Keterangan

Memanggil Add metode akan meningkatkan CollectionChanged peristiwa.

Berlaku untuk

Bagikan melalui

ControlBindingsCollection.Add Metode

Definisi

Overload

Add(Binding)

Parameter

Pengecualian

Contoh

Keterangan

Berlaku untuk

Add(String, Object, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Berlaku untuk

Add(String, Object, String, Boolean)

Parameter

Mengembalikan

Pengecualian

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

Sumber Daya Tambahan: