Binding Konstruktory

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Inicializuje novou instanci Binding třídy.

Přetížení

Name	Description
Binding(String, Object, String)	Inicializuje novou instanci Binding třídy, která jednoduše vytvoří vazbu označené vlastnosti ovládacího prvku na zadaný datový člen zdroje dat.
Binding(String, Object, String, Boolean)	Inicializuje novou instanci Binding třídy, která sváže uvedenou vlastnost ovládacího prvku se zadaným datovým členem zdroje dat, a volitelně umožňuje použít formátování.
Binding(String, Object, String, Boolean, DataSourceUpdateMode)	Inicializuje novou instanci Binding třídy, která váže zadanou vlastnost ovládacího prvku na zadaný datový člen zadaného zdroje dat. Volitelně umožňuje formátování a šíření hodnot do zdroje dat na základě zadaného nastavení aktualizace.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Inicializuje novou instanci Binding třídy, která vytvoří vazbu označené vlastnosti ovládacího prvku na zadaný datový člen zadaného zdroje dat. Volitelně umožňuje formátování, rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace a nastaví vlastnost na zadanou hodnotu při DBNull vrácení ze zdroje dat.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Inicializuje novou instanci Binding třídy, která váže zadanou vlastnost ovládacího prvku na zadaný datový člen zadaného zdroje dat. Volitelně umožňuje formátování pomocí zadaného řetězce formátu; rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace; a nastaví vlastnost na zadanou hodnotu při DBNull vrácení ze zdroje dat.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Inicializuje novou instanci Binding třídy se zadanou ovládací vlastnost pro zadaný datový člen zadaného zdroje dat. Volitelně umožňuje formátování pomocí zadaného řetězce formátu; rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace; umožňuje formátování pomocí zadaného řetězce formátu; nastaví vlastnost na zadanou hodnotu při DBNull vrácení ze zdroje dat a nastaví zadaného zprostředkovatele formátu.

Binding(String, Object, String)

Zdroj:

Binding.cs

Inicializuje novou instanci Binding třídy, která jednoduše vytvoří vazbu označené vlastnosti 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);

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.

dataSource

Object

Představuje Object zdroj dat.

dataMember

String

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

Výjimky

Exception

propertyName není platná vlastnost ovládacího prvku ani prázdný řetězec ("").

ArgumentException

Vlastnost zadanou uživatelem propertyName neexistuje v ovládacím prvku.

Příklady

Následující příklad kódu vytvoří vazbu TextBox ovládacího prvku na sloupec tabulky v pojmenovaném DataSetmyDataSet. Příklad vyžaduje, abyste deklarovali myDataSet v části deklarací modulu.

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:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Libovolná třída, která implementuje IList rozhraní

• Libovolná třída

Další informace o vytvoření Binding řetězce najdete ve dataMember třídě.

Když vytvoříte vazbu na vlastnost ovládacího prvku, nová Binding zkontroluje události vystavené vázaného ovládacího prvku a připojí se ke dvěma konkrétním událostem:

• Control.Validating

• Událost s názvem PropertyNameChanged (například Control.BackColorChanged)

Pokud se pokusíte vytvořit vazbu na vlastnost, která neexistuje, ArgumentException vyvolá se při Binding přidání do kolekce ovládacího prvku Control.DataBindings .

Viz také

• BindingsCollection
• CurrencyManager

Binding(String, Object, String, Boolean)

Zdroj:

Binding.cs

Inicializuje novou instanci Binding třídy, která sváže uvedenou vlastnost ovládacího prvku se zadaným datovým členem zdroje dat, a volitelně umožňuje použít 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);

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.

dataSource

Object

Představuje Object zdroj dat.

dataMember

String

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

formattingEnabled

Boolean

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

Výjimky

ArgumentException

Vlastnost zadanou uživatelem propertyName neexistuje v ovládacím prvku.

nebo

Zadanou vlastností je vlastnost jen pro čtení.

Exception

Formátování je zakázáno a propertyName není platná vlastnost ovládacího prvku ani prázdný řetězec ("").

Binding(String, Object, String, Boolean, DataSourceUpdateMode)

Zdroj:

Binding.cs

Inicializuje novou instanci Binding třídy, která váže zadanou vlastnost ovládacího prvku na zadaný datový člen zadaného zdroje dat. Volitelně umožňuje formátování a šíření hodnot 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);

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.

dataSource

Object

Představuje Object zdroj dat.

dataMember

String

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

formattingEnabled

Boolean

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

dataSourceUpdateMode

DataSourceUpdateMode

Jedna z DataSourceUpdateMode hodnot.

Výjimky

ArgumentException

Vlastnost zadanou uživatelem propertyName neexistuje v ovládacím prvku.

nebo

Zadaný zdroj dat nebo datový člen 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:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Libovolná třída, která implementuje IList rozhraní

• Libovolná třída

Další informace o vytvoření Binding řetězce najdete ve dataMember třídě.

Když vytvoříte vazbu na vlastnost ovládacího prvku, nová Binding zkontroluje události vystavené vázaného ovládacího prvku a připojí se ke dvěma konkrétním událostem:

• Control.Validating.

• Událost s názvem PropertyNameChanged (například Control.BackColorChanged)

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Zdroj:

Binding.cs

Inicializuje novou instanci Binding třídy, která vytvoří vazbu označené vlastnosti ovládacího prvku na zadaný datový člen zadaného zdroje dat. Volitelně umožňuje formátování, rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace a nastaví vlastnost na zadanou hodnotu při DBNull 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);

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.

dataSource

Object

Představuje Object zdroj dat.

dataMember

String

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

formattingEnabled

Boolean

truenaformá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

ArgumentException

Vlastnost zadanou uživatelem propertyName neexistuje v ovládacím prvku.

nebo

Zadaný zdroj dat nebo datový člen 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:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Libovolná třída, která implementuje IList rozhraní

• Libovolná třída

Další informace o vytvoření Binding řetězce najdete ve dataMember třídě.

Když vytvoříte vazbu na vlastnost ovládacího prvku, nová Binding zkontroluje události vystavené vázaného ovládacího prvku a připojí se ke dvěma konkrétním událostem:

• Control.Validating

• Událost s názvem PropertyNameChanged (například Control.BackColorChanged)

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Zdroj:

Binding.cs

Inicializuje novou instanci Binding třídy, která váže zadanou vlastnost ovládacího prvku na zadaný datový člen zadaného zdroje dat. Volitelně umožňuje formátování pomocí zadaného řetězce formátu; rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace; a nastaví vlastnost na zadanou hodnotu při DBNull 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, System::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.

dataSource

Object

Představuje Object zdroj dat.

dataMember

String

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

formattingEnabled

Boolean

truenaformá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í způsob zobrazení hodnoty.

Výjimky

ArgumentException

Vlastnost zadanou uživatelem propertyName neexistuje v ovládacím prvku.

nebo

Zadaný zdroj dat nebo datový člen 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:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Libovolná třída, která implementuje IList rozhraní

• Libovolná třída

Další informace o vytvoření Binding řetězce najdete ve dataMember třídě.

Když vytvoříte vazbu na vlastnost ovládacího prvku, nová Binding zkontroluje události vystavené vázaného ovládacího prvku a připojí se ke dvěma konkrétním událostem:

• Control.Validating

• Událost s názvem PropertyNameChanged (například Control.BackColorChanged)

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

Zdroj:

Binding.cs

Inicializuje novou instanci Binding třídy se zadanou ovládací vlastnost pro zadaný datový člen zadaného zdroje dat. Volitelně umožňuje formátování pomocí zadaného řetězce formátu; rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace; umožňuje formátování pomocí zadaného řetězce formátu; nastaví vlastnost na zadanou hodnotu při DBNull 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);

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.

dataSource

Object

Představuje Object zdroj dat.

dataMember

String

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

formattingEnabled

Boolean

truenaformá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í způsob zobrazení hodnoty.

formatInfo

IFormatProvider

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

Výjimky

ArgumentException

Vlastnost zadanou uživatelem propertyName neexistuje v ovládacím prvku.

nebo

Zadaný zdroj dat nebo datový člen 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:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Libovolná třída, která implementuje IList rozhraní

• Libovolná třída

Další informace o vytvoření Binding řetězce najdete ve dataMember třídě.

Když vytvoříte vazbu na vlastnost ovládacího prvku, nová Binding zkontroluje události vystavené vázaného ovládacího prvku a připojí se ke dvěma konkrétním událostem:

• Control.Validating

• Událost s názvem PropertyNameChanged (například Control.BackColorChanged)