Binding Konstruktory
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í.
Inicializuje novou instanci Binding třídy.
Přetížení
Binding(String, Object, String) |
Inicializuje novou instanci Binding třídy, která simple-váže vlastnost určeného ovládacího prvku na zadaný datový člen zdroje dat. |
Binding(String, Object, String, Boolean) |
Inicializuje novou instanci Binding třídy, která sváže určenou vlastnost ovládacího prvku se zadaným datovým členem zdroje dat a volitelně povolí použití formátování. |
Binding(String, Object, String, Boolean, DataSourceUpdateMode) |
Inicializuje novou instanci Binding třídy, která sváže zadanou vlastnost ovládacího prvku na zadaný datový člen zadaného zdroje dat. Volitelně povolí formátování a rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace. |
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object) |
Inicializuje novou instanci Binding třídy, která sváže určenou vlastnost ovládacího prvku se zadaným datovým členem zadaného zdroje dat. Volitelně povolí formátování, rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace a nastaví vlastnost na zadanou DBNull hodnotu při vrácení ze zdroje dat. |
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String) |
Inicializuje novou instanci Binding třídy, 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; šíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace; a nastaví vlastnost na zadanou DBNull hodnotu, když se vrátí ze zdroje dat. |
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider) |
Inicializuje novou instanci Binding třídy se zadaným ovládacím prvku vlastnost zadaného datového člena zadaného zdroje dat. Volitelně povolí formátování pomocí zadaného řetězce formátu; šíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace; umožňuje formátování se zadaným formátovacím řetězcem; nastaví vlastnost na zadanou DBNull hodnotu při vrácení ze zdroje dat a nastaví zadaného zprostředkovatele formátu. |
Binding(String, Object, String)
Inicializuje novou instanci Binding třídy, která simple-váže vlastnost určeného ovládacího prvku na zadaný datový člen zdroje dat.
public:
Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember);
public Binding (string propertyName, object dataSource, string dataMember);
public Binding (string propertyName, object? dataSource, string? dataMember);
new System.Windows.Forms.Binding : string * obj * string -> System.Windows.Forms.Binding
Public Sub New (propertyName As String, dataSource As Object, dataMember As String)
Parametry
- propertyName
- String
Název vlastnosti ovládacího prvku, který se má svázat.
- dataMember
- String
Vlastnost nebo seznam, se které chcete vytvořit vazbu.
Výjimky
propertyName
není platná vlastnost ovládacího prvku ani prázdný řetězec ("").
Vlastnost daná nástrojem propertyName
neexistuje v ovládacím prvku.
Příklady
Následující příklad kódu vytvoří TextBox vazbu ovládacího prvku na sloupec tabulky v pojmenovaném myDataSet
objektu DataSet . Příklad vyžaduje, abyste v části deklarace modulu deklarovali myDataSet
.
private:
void CreateDataSet()
{
myDataSet = gcnew DataSet( "myDataSet" );
/* Populates the DataSet with tables, relations, and
constraints. */
}
void BindTextBoxToDataSet()
{
/* Binds a TextBox control to a DataColumn named
CompanyName in the DataTable named Suppliers. */
textBox1->DataBindings->Add(
"Text", myDataSet, "Suppliers.CompanyName" );
}
private void CreateDataSet()
{
myDataSet = new DataSet("myDataSet");
/* Populates the DataSet with tables, relations, and
constraints. */
}
private void BindTextBoxToDataSet()
{
/* Binds a TextBox control to a DataColumn named
CompanyName in the DataTable named Suppliers. */
textBox1.DataBindings.Add
("Text", myDataSet, "Suppliers.CompanyName");
}
Private Sub CreateDataSet
myDataSet = new DataSet("myDataSet")
' Populates the DataSet with tables, relations, and
' constraints.
End Sub
Private Sub BindTextBoxToDataSet
' Binds a TextBox control to a column in the DataSet.
textBox1.DataBindings.Add _
("Text", myDataSet, "Suppliers.CompanyName")
End Sub
Poznámky
Pro zdroj dat můžete zadat instanci některé z následujících tříd:
Libovolná třída, která implementuje IList rozhraní
Libovolná třída
Další informace o vytvoření řetězce najdete ve BindingdataMember
třídě.
Když vytvoříte vazbu na vlastnost ovládacího prvku, nový Binding zkontroluje události vystavené vázaným ovládacím prvku a připojí se ke dvěma konkrétním událostem:
Událost s názvem PropertyName
Changed
(například Control.BackColorChanged)
Pokud se pokusíte vytvořit vazbu na vlastnost, která neexistuje, ArgumentException bude vyvolán při Binding přidání do kolekce ovládacího prvku Control.DataBindings .
Viz také
Platí pro
Binding(String, Object, String, Boolean)
Inicializuje novou instanci Binding třídy, která sváže určenou vlastnost ovládacího prvku se zadaným datovým členem zdroje dat a volitelně povolí použití formátování.
public:
Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled);
public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled);
public Binding (string propertyName, object? dataSource, string? dataMember, bool formattingEnabled);
new System.Windows.Forms.Binding : string * obj * string * bool -> System.Windows.Forms.Binding
Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean)
Parametry
- propertyName
- String
Název vlastnosti ovládacího prvku, který se má svázat.
- dataMember
- String
Vlastnost nebo seznam, se které chcete vytvořit vazbu.
- formattingEnabled
- Boolean
true
formátovat zobrazená data; v opačném případě . false
Výjimky
Vlastnost daná nástrojem propertyName
neexistuje v ovládacím prvku.
-nebo-
Zadanou vlastností je vlastnost jen pro čtení.
Formátování je zakázané a propertyName
není platnou vlastností ovládacího prvku ani prázdným řetězcem ("").
Platí pro
Binding(String, Object, String, Boolean, DataSourceUpdateMode)
Inicializuje novou instanci Binding třídy, která sváže zadanou vlastnost ovládacího prvku na zadaný datový člen zadaného zdroje dat. Volitelně povolí formátování a rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace.
public:
Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode);
public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode);
public Binding (string propertyName, object? dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode);
new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode -> System.Windows.Forms.Binding
Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode)
Parametry
- propertyName
- String
Název vlastnosti ovládacího prvku, který se má svázat.
- dataMember
- String
Vlastnost nebo seznam, se které chcete vytvořit vazbu.
- formattingEnabled
- Boolean
true
formátovat zobrazená data; v opačném případě . false
- dataSourceUpdateMode
- DataSourceUpdateMode
Jedna z DataSourceUpdateMode hodnot.
Výjimky
Vlastnost daná nástrojem propertyName
neexistuje v ovládacím prvku.
-nebo-
Zadaný zdroj dat, člen dat nebo vlastnost ovládacího prvku jsou přidruženy k jiné vazbě v kolekci.
Poznámky
Pro zdroj dat můžete zadat instanci některé z následujících tříd:
Libovolná třída, která implementuje IList rozhraní
Libovolná třída
Další informace o vytvoření řetězce najdete ve BindingdataMember
třídě.
Když vytvoříte vazbu na vlastnost ovládacího prvku, nový Binding zkontroluje události vystavené vázaným ovládacím prvku a připojí se ke dvěma konkrétním událostem:
Událost s názvem PropertyName
Changed
(například Control.BackColorChanged)
Platí pro
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)
Inicializuje novou instanci Binding třídy, která sváže určenou vlastnost ovládacího prvku se zadaným datovým členem zadaného zdroje dat. Volitelně povolí formátování, rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace a nastaví vlastnost na zadanou DBNull hodnotu při vrácení ze zdroje dat.
public:
Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode, System::Object ^ nullValue);
public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object nullValue);
public Binding (string propertyName, object? dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object? nullValue);
new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj -> System.Windows.Forms.Binding
Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object)
Parametry
- propertyName
- String
Název vlastnosti ovládacího prvku, který se má svázat.
- dataMember
- String
Vlastnost nebo seznam, se které chcete vytvořit vazbu.
- formattingEnabled
- Boolean
true
formátovat zobrazená data; v opačném případě . false
- dataSourceUpdateMode
- DataSourceUpdateMode
Jedna z DataSourceUpdateMode hodnot.
- nullValue
- Object
Vlastnost Object vázaného ovládacího prvku se použije, pokud je DBNullhodnota zdroje dat .
Výjimky
Vlastnost daná nástrojem propertyName
neexistuje v ovládacím prvku.
-nebo-
Zadaný zdroj dat, člen dat nebo vlastnost ovládacího prvku jsou přidruženy k jiné vazbě v kolekci.
Poznámky
Pro zdroj dat můžete zadat instanci některé z následujících tříd:
Libovolná třída, která implementuje IList rozhraní
Libovolná třída
Další informace o vytvoření řetězce najdete ve BindingdataMember
třídě.
Když vytvoříte vazbu na vlastnost ovládacího prvku, nový Binding zkontroluje události vystavené vázaným ovládacím prvku a připojí se ke dvěma konkrétním událostem:
Událost s názvem PropertyName
Changed
(například Control.BackColorChanged)
Platí pro
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)
Inicializuje novou instanci Binding třídy, 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; šíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace; a nastaví vlastnost na zadanou DBNull hodnotu, když se vrátí ze zdroje dat.
public:
Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode, System::Object ^ nullValue, System::String ^ formatString);
public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object nullValue, string formatString);
public Binding (string propertyName, object? dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object? nullValue, string formatString);
new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string -> System.Windows.Forms.Binding
Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object, formatString As String)
Parametry
- propertyName
- String
Název vlastnosti ovládacího prvku, který se má svázat.
- dataMember
- String
Vlastnost nebo seznam, se které chcete vytvořit vazbu.
- formattingEnabled
- Boolean
true
formátovat zobrazená data; v opačném případě . false
- dataSourceUpdateMode
- DataSourceUpdateMode
Jedna z DataSourceUpdateMode hodnot.
- nullValue
- Object
Vlastnost Object vázaného ovládacího prvku se použije, pokud je DBNullhodnota zdroje dat .
- formatString
- String
Jeden nebo více znaků specifikátoru formátu, které označují, jak má být hodnota zobrazena.
Výjimky
Vlastnost daná nástrojem propertyName
neexistuje v ovládacím prvku.
-nebo-
Zadaný zdroj dat, člen dat nebo vlastnost ovládacího prvku jsou přidruženy k jiné vazbě v kolekci.
Poznámky
Pro zdroj dat můžete zadat instanci některé z následujících tříd:
Libovolná třída, která implementuje IList rozhraní
Libovolná třída
Další informace o vytvoření řetězce najdete ve BindingdataMember
třídě.
Když vytvoříte vazbu na vlastnost ovládacího prvku, nový Binding zkontroluje události vystavené vázaným ovládacím prvku a připojí se ke dvěma konkrétním událostem:
Událost s názvem PropertyName
Changed
(například Control.BackColorChanged)
Platí pro
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)
Inicializuje novou instanci Binding třídy se zadaným ovládacím prvku vlastnost zadaného datového člena zadaného zdroje dat. Volitelně povolí formátování pomocí zadaného řetězce formátu; šíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace; umožňuje formátování se zadaným formátovacím řetězcem; nastaví vlastnost na zadanou DBNull hodnotu při vrácení ze zdroje dat a nastaví zadaného zprostředkovatele formátu.
public:
Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode, System::Object ^ nullValue, System::String ^ formatString, IFormatProvider ^ formatInfo);
public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object nullValue, string formatString, IFormatProvider formatInfo);
public Binding (string propertyName, object? dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object? nullValue, string formatString, IFormatProvider? formatInfo);
new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string * IFormatProvider -> System.Windows.Forms.Binding
Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object, formatString As String, formatInfo As IFormatProvider)
Parametry
- propertyName
- String
Název vlastnosti ovládacího prvku, který se má svázat.
- dataMember
- String
Vlastnost nebo seznam, se které chcete vytvořit vazbu.
- formattingEnabled
- Boolean
true
formátovat zobrazená data; v opačném případě . false
- dataSourceUpdateMode
- DataSourceUpdateMode
Jedna z DataSourceUpdateMode hodnot.
- nullValue
- Object
Vlastnost Object vázaného ovládacího prvku se použije, pokud je DBNullhodnota zdroje dat .
- 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í.
Výjimky
Vlastnost daná nástrojem propertyName
neexistuje v ovládacím prvku.
-nebo-
Zadaný zdroj dat, člen dat nebo vlastnost ovládacího prvku jsou přidruženy k jiné vazbě v kolekci.
Poznámky
Pro zdroj dat můžete zadat instanci některé z následujících tříd:
Libovolná třída, která implementuje IList rozhraní
Libovolná třída
Další informace o vytvoření řetězce najdete ve BindingdataMember
třídě.
Když vytvoříte vazbu na vlastnost ovládacího prvku, nový Binding zkontroluje události vystavené vázaným ovládacím prvku a připojí se ke dvěma konkrétním událostem:
Událost s názvem PropertyName
Changed
(například Control.BackColorChanged)