Sdílet prostřednictvím

Binding Konstruktory

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Inicializuje novou instanci Binding třídy.

Přetížení

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á sváže uvedenou vlastnost ovládacího prvku se zadaným datovým členem 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, když se ze zdroje dat vrátí DBNull.
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 je 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í zadaného datového členu 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, pokud se z zdroje dat vrátí DBNull; a nastaví zadaného zprostředkovatele formátu.

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.

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

Object, který představuje 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 poskytnutá propertyName v ovládacím prvku neexistuje.

Příklady

Následující příklad kódu vytvoří vazbu TextBox ovládacího prvku na sloupec tabulky v DataSet pojmenované myDataSet. 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:

Další informace o vytvoření řetězce dataMember najdete v Binding 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:

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

Viz také

Platí pro

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

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

Object, který představuje zdroj dat.

dataMember
String

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

formattingEnabled
Boolean

true naformátovat zobrazená data; jinak false.

Výjimky

ArgumentException

Vlastnost poskytnutá propertyName v ovládacím prvku neexistuje.

-nebo-

Zadanou vlastností je vlastnost jen pro čtení.

Exception

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

Platí pro

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.

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

Object představující zdroj dat.

dataMember
String

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

formattingEnabled
Boolean

true naformátovat zobrazená data; jinak false.

dataSourceUpdateMode
DataSourceUpdateMode

Jedna z DataSourceUpdateMode hodnot.

Výjimky

ArgumentException

Vlastnost poskytnutá propertyName v ovládacím prvku neexistuje.

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

Další informace o vytvoření řetězce dataMember najdete v Binding 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:

Platí pro

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

Inicializuje novou instanci Binding třídy, která sváže uvedenou vlastnost ovládacího prvku se zadaným datovým členem 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, když se ze zdroje dat vrátí DBNull.

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

Object představující zdroj dat.

dataMember
String

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

formattingEnabled
Boolean

true naformátovat zobrazená data; jinak false.

dataSourceUpdateMode
DataSourceUpdateMode

Jedna z DataSourceUpdateMode hodnot.

nullValue
Object

Object, která se má použít na vlastnost vázaného ovládacího prvku, pokud je hodnota zdroje dat DBNull.

Výjimky

ArgumentException

Vlastnost poskytnutá propertyName v ovládacím prvku neexistuje.

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

Další informace o vytvoření řetězce dataMember najdete v Binding 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:

Platí pro

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 je 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);
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

Object představující zdroj dat.

dataMember
String

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

formattingEnabled
Boolean

true naformátovat zobrazená data; jinak false.

dataSourceUpdateMode
DataSourceUpdateMode

Jedna z DataSourceUpdateMode hodnot.

nullValue
Object

Object, která se má použít na vlastnost vázaného ovládacího prvku, pokud je hodnota zdroje dat DBNull.

formatString
String

Jeden nebo více znaků specifikátoru formátu, které označují způsob zobrazení hodnoty.

Výjimky

ArgumentException

Vlastnost poskytnutá propertyName v ovládacím prvku neexistuje.

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

Další informace o vytvoření řetězce dataMember najdete v Binding 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:

Platí pro

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

Inicializuje novou instanci Binding třídy se zadanou ovládací vlastností zadaného datového členu 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, pokud se z zdroje dat vrátí DBNull; 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

Object představující zdroj dat.

dataMember
String

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

formattingEnabled
Boolean

true naformátovat zobrazená data; jinak false.

dataSourceUpdateMode
DataSourceUpdateMode

Jedna z DataSourceUpdateMode hodnot.

nullValue
Object

Object, která se má použít na vlastnost vázaného ovládacího prvku, pokud je hodnota zdroje dat DBNull.

formatString
String

Jeden nebo více znaků specifikátoru formátu, které označují způsob zobrazení hodnoty.

formatInfo
IFormatProvider

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

Výjimky

ArgumentException

Vlastnost poskytnutá propertyName v ovládacím prvku neexistuje.

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

Další informace o vytvoření řetězce dataMember najdete v Binding 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:

Platí pro