Binding Konstruktory

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í.

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.

dataSource: Object

Objekt Object , který představuje zdroj dat.

dataMember: String

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

Výjimky

Exception

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

ArgumentException

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 myDataSetobjektu 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:

DataSet
DataTable
DataView
DataViewManager
BindingSource
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:

Control.Validating
Událost s názvem PropertyNameChanged (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.

dataSource: Object

Objekt Object , který představuje 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

Výjimky

ArgumentException

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

-nebo-

Zadanou vlastností je vlastnost jen pro čtení.

Exception

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.

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

dataSourceUpdateMode: DataSourceUpdateMode

Jedna z DataSourceUpdateMode hodnot.

Výjimky

ArgumentException

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:

DataSet
DataTable
DataView
DataViewManager
BindingSource
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:

Control.Validating.
Událost s názvem PropertyNameChanged (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.

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

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 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:

DataSet
DataTable
DataView
DataViewManager
BindingSource
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:

Control.Validating
Událost s názvem PropertyNameChanged (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.

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

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

ArgumentException

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:

DataSet
DataTable
DataView
DataViewManager
BindingSource
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:

Control.Validating
Událost s názvem PropertyNameChanged (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.

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

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

ArgumentException

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:

DataSet
DataTable
DataView
DataViewManager
BindingSource
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:

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

Platí pro

Binding Konstruktory

Definice

Přetížení

Binding(String, Object, String)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Binding(String, Object, String, Boolean)

Parametry

Výjimky

Platí pro

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

Parametry

Výjimky

Poznámky

Platí pro

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

Parametry

Výjimky

Poznámky

Platí pro

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

Parametry

Výjimky

Poznámky

Platí pro

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

Parametry

Výjimky

Poznámky

Platí pro

Váš názor

Další materiály