ControlBindingsCollection.Add Metoda
Definice
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í.
Binding Přidá do kolekce.
Přetížení
| Name | Description |
|---|---|
| Add(Binding) |
Přidá zadaný Binding objekt do kolekce. |
| Add(String, Object, String) |
Binding Vytvoří pomocí 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 formátování povoleno, a přidá vazbu do kolekce. |
| Add(String, Object, String, Boolean, DataSourceUpdateMode) |
Vytvoří vazbu, která vytvoří vazbu zadané vlastnosti ovládacího prvku na zadaný datový člen zadaného zdroje dat, volitelně povolení formátování, šíření hodnot do zdroje dat na základě zadaného nastavení aktualizace a přidání vazby do kolekce. |
| Add(String, Object, String, Boolean, DataSourceUpdateMode, Object) |
Vytvoří vazbu, která vytvoří vazbu zadané vlastnosti ovládacího prvku na zadaný datový člen zadaného zdroje dat, volitelně povolení formátování, šíření hodnot do zdroje dat na základě zadaného nastavení aktualizace, nastavení vlastnosti na zadanou hodnotu při DBNull vrácení ze zdroje dat a přidání vazby do kolekce. |
| Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String) |
Vytvoří vazbu, která vytvoří vazbu zadané vlastnosti ovládacího prvku na zadaný datový člen zadaného zdroje dat, volitelně povolení formátování pomocí zadaného formátovacího řetězce, šíření hodnot do zdroje dat na základě zadaného nastavení aktualizace, nastavení vlastnosti na zadanou hodnotu při DBNull vrácení ze zdroje dat a přidání vazby do kolekce. |
| Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider) |
Vytvoří vazbu, která vytvoří vazbu zadané vlastnosti ovládacího prvku na zadaný datový člen zadaného zdroje dat, volitelně povolení formátování pomocí zadaného řetězce formátu, šíření hodnot do zdroje dat na základě zadaného nastavení aktualizace, nastavení vlastnosti na zadanou hodnotu při DBNull vrácení ze zdroje dat, nastavení 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
Výjimky
Hodnota binding null.
Příklady
Následující příklad kódu vytvoří Binding instanci a pomocí Add metody přidá instanci do ControlBindingsCollectionTextBox 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 DataSourceUpdateModeBinding vytvořené tímto přetížením Add metody je nastavena na hodnotu DefaultDataSourceUpdateMode vlastnosti.
Událost CollectionChanged nastane po dokončení změny.
Platí pro
Add(String, Object, String)
Binding Vytvoří pomocí 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.
- dataMember
- String
Vlastnost nebo seznam, ke které chcete vytvořit vazbu.
Návraty
Nově vytvořený Binding.
Výjimky
To binding je null.
Příklady
Následující příklad kódu používá metodu Add k přidání tří Binding objektů do ControlBindingsCollectionTextBox ovládacího prvku. Tato ControlBindingsCollection vlastnost je přístupná prostřednictvím DataBindings 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 DataSourceUpdateModeBinding vytvořené tímto přetížením Add metody je nastavena na hodnotu DefaultDataSourceUpdateMode vlastnosti.
Binding Přidání příčiny výskytu CollectionChanged 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 formátování povoleno, 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.
- dataMember
- String
Vlastnost nebo seznam, ke které chcete vytvořit vazbu.
- formattingEnabled
- Boolean
truenaformátovat zobrazená data; v opačném případě . false
Návraty
Nově vytvořený Binding.
Výjimky
Vlastnost zadanou uživatelem propertyName neexistuje v ovládacím prvku.
nebo
Zadanou vlastností je vlastnost jen pro čtení.
Pokud je formátování zakázáno a propertyName není platná vlastnost ovládacího prvku ani prázdný řetězec ("").
Platí pro
Add(String, Object, String, Boolean, DataSourceUpdateMode)
Vytvoří vazbu, která vytvoří vazbu zadané vlastnosti ovládacího prvku na zadaný datový člen zadaného zdroje dat, volitelně povolení formátování, šíření hodnot do zdroje dat na základě zadaného nastavení aktualizace a přidání vazby 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.
- dataMember
- String
Vlastnost nebo seznam, ke které chcete vytvořit vazbu.
- formattingEnabled
- Boolean
truenaformátovat zobrazená data; v opačném případě . false
- updateMode
- DataSourceUpdateMode
Jedna z DataSourceUpdateMode hodnot.
Návraty
Nově vytvořený Binding.
Výjimky
Vlastnost poskytnutá propertyName ovládacím prvku neexistuje nebo je určena jen pro čtení.
nebo
Zadaný datový člen ve zdroji dat neexistuje.
nebo
Zadaný zdroj dat, datový člen nebo vlastnost ovládacího prvku jsou přidruženy k jiné vazbě v kolekci.
Poznámky
Volání metody Add vyvolá CollectionChanged událost.
Platí pro
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)
Vytvoří vazbu, která vytvoří vazbu zadané vlastnosti ovládacího prvku na zadaný datový člen zadaného zdroje dat, volitelně povolení formátování, šíření hodnot do zdroje dat na základě zadaného nastavení aktualizace, nastavení vlastnosti na zadanou hodnotu při DBNull vrácení ze zdroje dat a přidání vazby 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);
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.
- dataMember
- String
Vlastnost nebo seznam, ke které chcete vytvořit vazbu.
- formattingEnabled
- Boolean
truenaformátovat zobrazená data; v opačném případě . false
- updateMode
- DataSourceUpdateMode
Jedna z DataSourceUpdateMode hodnot.
Návraty
Nově vytvořený Binding.
Výjimky
Vlastnost poskytnutá propertyName ovládacím prvku neexistuje nebo je určena jen pro čtení.
nebo
Zadaný datový člen ve zdroji dat neexistuje.
nebo
Zadaný zdroj dat, datový člen nebo vlastnost ovládacího prvku jsou přidruženy k jiné vazbě v kolekci.
Poznámky
Volání metody Add vyvolá CollectionChanged událost.
Platí pro
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)
Vytvoří vazbu, která vytvoří vazbu zadané vlastnosti ovládacího prvku na zadaný datový člen zadaného zdroje dat, volitelně povolení formátování pomocí zadaného formátovacího řetězce, šíření hodnot do zdroje dat na základě zadaného nastavení aktualizace, nastavení vlastnosti na zadanou hodnotu při DBNull vrácení ze zdroje dat a přidání vazby 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.
- dataMember
- String
Vlastnost nebo seznam, ke které chcete vytvořit vazbu.
- formattingEnabled
- Boolean
truenaformátovat zobrazená data; v opačném případě . false
- updateMode
- DataSourceUpdateMode
Jedna z DataSourceUpdateMode hodnot.
- formatString
- String
Jeden nebo více znaků specifikátoru formátu, které označují způsob zobrazení hodnoty.
Návraty
Nově vytvořený Binding.
Výjimky
Vlastnost poskytnutá propertyName ovládacím prvku neexistuje nebo je určena jen pro čtení.
nebo
Zadaný datový člen ve zdroji dat neexistuje.
nebo
Zadaný zdroj dat, datový člen nebo vlastnost ovládacího prvku jsou přidruženy k jiné vazbě v kolekci.
Poznámky
Volání metody Add vyvolá CollectionChanged událost.
Platí pro
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)
Vytvoří vazbu, která vytvoří vazbu zadané vlastnosti ovládacího prvku na zadaný datový člen zadaného zdroje dat, volitelně povolení formátování pomocí zadaného řetězce formátu, šíření hodnot do zdroje dat na základě zadaného nastavení aktualizace, nastavení vlastnosti na zadanou hodnotu při DBNull vrácení ze zdroje dat, nastavení zadaného zprostředkovatele formátu, a přidání vazby 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, 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.
- dataMember
- String
Vlastnost nebo seznam, ke které chcete vytvořit vazbu.
- formattingEnabled
- Boolean
truenaformátovat zobrazená data; v opačném případě . false
- updateMode
- DataSourceUpdateMode
Jedna z DataSourceUpdateMode hodnot.
- formatString
- String
Jeden nebo více znaků specifikátoru formátu, které označují způsob zobrazení hodnoty.
- formatInfo
- IFormatProvider
Implementace přepsání výchozího IFormatProvider chování formátování.
Návraty
Nově vytvořený Binding.
Výjimky
Vlastnost poskytnutá propertyName ovládacím prvku neexistuje nebo je určena jen pro čtení.
nebo
Zadaný datový člen ve zdroji dat neexistuje.
nebo
Zadaný zdroj dat, datový člen nebo vlastnost ovládacího prvku jsou přidruženy k jiné vazbě v kolekci.
Poznámky
Volání metody Add vyvolá CollectionChanged událost.