ControlBindingsCollection.Add Metoda

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přidá do kolekce objekt Binding .

Přetížení

Add(Binding)	Přidá zadaný Binding objekt do kolekce.
Add(String, Object, String)	Vytvoří pomocí Binding zadaného názvu vlastnosti ovládacího prvku, zdroje dat a datového člena a přidá ho do kolekce.
Add(String, Object, String, Boolean)	Vytvoří vazbu se zadaným názvem vlastnosti ovládacího prvku, zdrojem dat, datovým členem a informacemi o tom, zda je povoleno formátování, a přidá vazbu do kolekce.
Add(String, Object, String, Boolean, DataSourceUpdateMode)	Vytvoří vazbu, která sváže zadanou vlastnost ovládacího prvku na zadaný datový člen zadaného zdroje dat, volitelně povolí formátování, rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace a přidá vazbu do kolekce.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Vytvoří vazbu, která sváže zadanou vlastnost ovládacího prvku na zadaný datový člen zadaného zdroje dat, volitelně povolí formátování, rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace, nastaví vlastnost na zadanou hodnotu při DBNull vrácení ze zdroje dat a přidá vazbu do kolekce.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Vytvoří vazbu, která sváže zadanou vlastnost ovládacího prvku na zadaný datový člen zadaného zdroje dat, volitelně povolí formátování pomocí zadaného řetězce formátu, rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace, nastaví vlastnost na zadanou hodnotu při DBNull vrácení ze zdroje dat a přidá vazbu do kolekce.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Vytvoří vazbu, která sváže zadanou vlastnost ovládacího prvku na zadaný datový člen zadaného zdroje dat, volitelně povolí formátování pomocí zadaného řetězce formátu, rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace, nastaví vlastnost na zadanou hodnotu při DBNull vrácení ze zdroje dat, nastaví zadaného zprostředkovatele formátu. a přidání vazby do kolekce.

Add(Binding)

Přidá zadaný Binding objekt do kolekce.

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

Příkaz Binding , který chcete přidat.

Výjimky

ArgumentNullException

Hodnota binding je null.

ArgumentException

Vlastnost ovládacího prvku je již vázána na data.

-nebo-

Parametr Binding neurčoval platný sloupec .DataSource

Příklady

Následující příklad kódu vytvoří Binding instanci a použije metodu Add k přidání instance do ControlBindingsCollection TextBox ovládacího prvku.

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

Poznámky

Vlastnost DataSourceUpdateMode Binding vytvořené tímto přetížením Add metody je nastavena na hodnotu DefaultDataSourceUpdateMode vlastnosti.

K CollectionChanged události dojde po dokončení změny.

Platí pro

Add(String, Object, String)

Vytvoří pomocí Binding zadaného názvu vlastnosti ovládacího prvku, zdroje dat a datového člena a přidá ho do kolekce.

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

Název vlastnosti ovládacího prvku, který se má svázat.

dataSource: Object

Objekt Object , který představuje zdroj dat.

dataMember: String

Vlastnost nebo seznam, se které chcete vytvořit vazbu.

Návraty

Binding

Nově vytvořená položka Binding.

Výjimky

ArgumentNullException

Hodnota binding je null.

Exception

Hodnota propertyName je již vázána na data.

-nebo-

Parametr dataMember neurčí platného člena souboru dataSource.

Příklady

Následující příklad kódu používá metodu Add k přidání tří Binding objektů do ControlBindingsCollection TextBox ovládacího prvku. K ControlBindingsCollection objektu DataBindings se přistupuje prostřednictvím vlastnosti Control třídy.

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

Poznámky

Vlastnost DataSourceUpdateMode Binding vytvořené tímto přetížením Add metody je nastavena na hodnotu DefaultDataSourceUpdateMode vlastnosti.

Přidání způsobí Binding , že CollectionChanged dojde k události.

Platí pro

Add(String, Object, String, Boolean)

Vytvoří vazbu se zadaným názvem vlastnosti ovládacího prvku, zdrojem dat, datovým členem a informacemi o tom, zda je povoleno formátování, a přidá vazbu do kolekce.

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

Název vlastnosti ovládacího prvku, který se má svázat.

dataSource: Object

Představuje Object zdroj dat.

dataMember: String

Vlastnost nebo seznam, se které chcete vytvořit vazbu.

formattingEnabled: Boolean

trueformátovat zobrazená data; v opačném případě . false

Návraty

Binding

Nově vytvořená položka Binding.

Výjimky

ArgumentException

Vlastnost daná nástrojem propertyName neexistuje v ovládacím prvku.

-nebo-

Zadanou vlastností je vlastnost jen pro čtení.

Exception

Pokud je formátování zakázané a hodnota propertyName není platnou vlastností ovládacího prvku ani prázdným řetězcem ("").

Platí pro

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

Vytvoří vazbu, která sváže zadanou vlastnost ovládacího prvku na zadaný datový člen zadaného zdroje dat, volitelně povolí formátování, rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace a přidá vazbu do kolekce.

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

Název vlastnosti ovládacího prvku, který se má svázat.

dataSource: Object

Představuje Object zdroj dat.

dataMember: String

Vlastnost nebo seznam, se které chcete vytvořit vazbu.

formattingEnabled: Boolean

trueformátovat zobrazená data; v opačném případě . false

updateMode: DataSourceUpdateMode

Jedna z DataSourceUpdateMode hodnot.

Návraty

Binding

Nově vytvořená položka Binding.

Výjimky

ArgumentException

Vlastnost daná nástrojem propertyName neexistuje v ovládacím prvku nebo je jen pro čtení.

-nebo-

Zadaný datový člen ve zdroji dat neexistuje.

-nebo-

Zadaný zdroj dat, člen dat nebo vlastnost ovládacího prvku jsou přidruženy k jiné vazbě v kolekci.

Poznámky

Add Volání metody vyvolá CollectionChanged událost.

Platí pro

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

Parametry

propertyName: String

Název vlastnosti ovládacího prvku, který se má svázat.

dataSource: Object

Představuje Object zdroj dat.

dataMember: String

Vlastnost nebo seznam, se které chcete vytvořit vazbu.

formattingEnabled: Boolean

trueformátovat zobrazená data; v opačném případě . false

updateMode: DataSourceUpdateMode

Jedna z DataSourceUpdateMode hodnot.

nullValue: Object

Pokud má zdroj dat tuto hodnotu, je vlastnost vázaná nastavena na DBNull.

Návraty

Binding

Nově vytvořená položka Binding.

Výjimky

ArgumentException

Vlastnost daná nástrojem propertyName neexistuje v ovládacím prvku nebo je jen pro čtení.

-nebo-

Zadaný datový člen ve zdroji dat neexistuje.

-nebo-

Zadaný zdroj dat, člen dat nebo vlastnost ovládacího prvku jsou přidruženy k jiné vazbě v kolekci.

Poznámky

Add Volání metody vyvolá CollectionChanged událost.

Platí pro

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

Vytvoří vazbu, která sváže zadanou vlastnost ovládacího prvku na zadaný datový člen zadaného zdroje dat, volitelně povolí formátování pomocí zadaného řetězce formátu, rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace, nastaví vlastnost na zadanou hodnotu při DBNull vrácení ze zdroje dat a přidá vazbu do kolekce.

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

Název vlastnosti ovládacího prvku, který se má svázat.

dataSource: Object

Představuje Object zdroj dat.

dataMember: String

Vlastnost nebo seznam, se které chcete vytvořit vazbu.

formattingEnabled: Boolean

trueformátovat zobrazená data; v opačném případě . false

updateMode: DataSourceUpdateMode

Jedna z DataSourceUpdateMode hodnot.

nullValue: Object

Pokud má zdroj dat tuto hodnotu, je vlastnost vázaná nastavena na DBNull.

formatString: String

Jeden nebo více znaků specifikátoru formátu, které označují, jak má být hodnota zobrazena.

Návraty

Binding

Nově vytvořená položka Binding.

Výjimky

ArgumentException

Vlastnost daná nástrojem propertyName neexistuje v ovládacím prvku nebo je jen pro čtení.

-nebo-

Zadaný datový člen ve zdroji dat neexistuje.

-nebo-

Zadaný zdroj dat, člen dat nebo vlastnost ovládacího prvku jsou přidruženy k jiné vazbě v kolekci.

Poznámky

Add Volání metody vyvolá CollectionChanged událost.

Platí pro

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

Název vlastnosti ovládacího prvku, který se má svázat.

dataSource: Object

Představuje Object zdroj dat.

dataMember: String

Vlastnost nebo seznam, se které chcete vytvořit vazbu.

formattingEnabled: Boolean

trueformátovat zobrazená data; v opačném případě . false

updateMode: DataSourceUpdateMode

Jedna z DataSourceUpdateMode hodnot.

nullValue: Object

Pokud má zdroj dat tuto hodnotu, je vlastnost vázaná nastavena na DBNull.

formatString: String

Jeden nebo více znaků specifikátoru formátu, které označují, jak má být hodnota zobrazena.

formatInfo: IFormatProvider

Implementace pro přepsání výchozího IFormatProvider chování formátování.

Návraty

Binding

Nově vytvořená položka Binding.

Výjimky

ArgumentException

Vlastnost daná nástrojem propertyName neexistuje v ovládacím prvku nebo je jen pro čtení.

-nebo-

Zadaný datový člen ve zdroji dat neexistuje.

-nebo-

Zadaný zdroj dat, člen dat nebo vlastnost ovládacího prvku jsou přidruženy k jiné vazbě v kolekci.

Poznámky

Add Volání metody vyvolá CollectionChanged událost.

Platí pro

Sdílet prostřednictvím

ControlBindingsCollection.Add Metoda

Definice

Přetížení

Add(Binding)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

Add(String, Object, String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

Add(String, Object, String, Boolean)

Parametry

Návraty

Výjimky

Platí pro

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

Parametry

Návraty

Výjimky

Poznámky

Platí pro

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

Parametry

Návraty

Výjimky

Poznámky

Platí pro

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

Parametry

Návraty

Výjimky

Poznámky

Platí pro

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

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Další materiály