Binding Konstruktorok

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Inicializálja a Binding osztály új példányát.

Túlterhelések

Name	Description
Binding(String, Object, String)	Inicializálja az Binding osztály új példányát, amely egyszerű kötéssel köti a megadott vezérlőtulajdonságot az adatforrás megadott adateleméhez.
Binding(String, Object, String, Boolean)	Inicializálja az Binding osztály új példányát, amely a megadott vezérlőtulajdonságot az adatforrás megadott adateleméhez köti, és opcionálisan lehetővé teszi a formázás alkalmazását.
Binding(String, Object, String, Boolean, DataSourceUpdateMode)	Inicializálja annak az osztálynak az Binding új példányát, amely a megadott vezérlőtulajdonságot a megadott adatforrás megadott adateleméhez köti. Opcionálisan engedélyezi a formázást, és a megadott frissítési beállítás alapján propagálja az értékeket az adatforrásba.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Inicializálja annak az osztálynak az Binding új példányát, amely a megadott vezérlőtulajdonságot a megadott adatforrás megadott adateleméhez köti. Opcionálisan engedélyezi a formázást, propagálja az értékeket az adatforrásba a megadott frissítési beállítás alapján, és a tulajdonságot a megadott értékre állítja, amikor az adatforrásból visszaad egy DBNull értéket.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Inicializálja annak az osztálynak az Binding új példányát, amely a megadott vezérlőtulajdonságot a megadott adatforrás megadott adateleméhez köti. Opcionálisan engedélyezi a megadott formázási sztringdel való formázást; a megadott frissítési beállítás alapján propagálja az értékeket az adatforrásba; és beállítja a tulajdonságot a megadott értékre, amikor az adatforrásból ad vissza egy DBNull értéket.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Inicializálja az Binding osztály új példányát a megadott vezérlőtulajdonság használatával a megadott adatforrás megadott adattagjára. Opcionálisan engedélyezi a megadott formázási sztringdel való formázást; a megadott frissítési beállítás alapján propagálja az értékeket az adatforrásba; engedélyezi a formázást a megadott formátumsztringgel; a tulajdonságot a megadott értékre állítja, amikor az adatforrásból ad vissza egy DBNull értéket, és beállítja a megadott formátumszolgáltatót.

Binding(String, Object, String)

Forrás:

Binding.cs

Inicializálja az Binding osztály új példányát, amely egyszerű kötéssel köti a megadott vezérlőtulajdonságot az adatforrás megadott adateleméhez.

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)

Paraméterek

propertyName

String

A kötéshez tartozó vezérlőtulajdonság neve.

dataSource

Object

Az Object adatforrást jelképező.

dataMember

String

Az a tulajdonság vagy lista, amelyhez csatlakozni szeretne.

Kivételek

Exception

propertyName sem egy vezérlőelem érvényes tulajdonsága, sem üres sztring ("").

ArgumentException

Az általa propertyName megadott tulajdonság nem létezik a vezérlőn.

Példák

Az alábbi példakód egy TextBox vezérlőelemet egy névvel ellátott DataSettáblaoszlophoz myDataSet köt. A példához a modul Deklarációk szakaszában kell deklarálnia 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

Megjegyzések

Az adatforráshoz az alábbi osztályok bármelyikének egy példányát adhatja meg:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Minden olyan osztály, amely megvalósítja az interfészt IList

• Bármely osztály

A sztring Binding létrehozásával kapcsolatos további információkért tekintse meg az osztályt dataMember .

Amikor kötést hoz létre egy vezérlő tulajdonságához, az új Binding a kötött vezérlőelem által közzétett eseményeket vizsgálja, és két konkrét eseményhez csatolja:

• Control.Validating

• TulajdonságnévChanged nevű esemény (például Control.BackColorChanged)

Ha olyan tulajdonsághoz próbál kötést kötni, amely nem létezik, ArgumentException a rendszer a vezérlő gyűjteményéhez Binding való hozzáadáskor Control.DataBindings egy parancsot küld.

Lásd még

• BindingsCollection
• CurrencyManager

Binding(String, Object, String, Boolean)

Forrás:

Binding.cs

Inicializálja az Binding osztály új példányát, amely a megadott vezérlőtulajdonságot az adatforrás megadott adateleméhez köti, és opcionálisan lehetővé teszi a formázás alkalmazását.

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)

Paraméterek

propertyName

String

A kötéshez tartozó vezérlőtulajdonság neve.

dataSource

Object

Az Object adatforrást jelképező.

dataMember

String

Az a tulajdonság vagy lista, amelyhez csatlakozni szeretne.

formattingEnabled

Boolean

truea megjelenített adatok formázása; egyéb esetben. false

Kivételek

ArgumentException

Az általa propertyName megadott tulajdonság nem létezik a vezérlőn.

-vagy-

A megadott tulajdonság írásvédett tulajdonság.

Exception

A formázás le van tiltva, és propertyName nem egy vezérlőelem érvényes tulajdonsága, sem üres sztring ("").

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

Forrás:

Binding.cs

Inicializálja annak az osztálynak az Binding új példányát, amely a megadott vezérlőtulajdonságot a megadott adatforrás megadott adateleméhez köti. Opcionálisan engedélyezi a formázást, és a megadott frissítési beállítás alapján propagálja az értékeket az adatforrásba.

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)

Paraméterek

propertyName

String

A kötéshez tartozó vezérlőtulajdonság neve.

dataSource

Object

Az Object adatforrást jelképező.

dataMember

String

Az a tulajdonság vagy lista, amelyhez csatlakozni szeretne.

formattingEnabled

Boolean

truea megjelenített adatok formázása; egyéb esetben. false

dataSourceUpdateMode

DataSourceUpdateMode

Az egyik DataSourceUpdateMode érték.

Kivételek

ArgumentException

Az általa propertyName megadott tulajdonság nem létezik a vezérlőn.

-vagy-

A megadott adatforrás, adattag vagy vezérlőtulajdonság a gyűjtemény egy másik kötéséhez van társítva.

Megjegyzések

Az adatforráshoz az alábbi osztályok bármelyikének egy példányát adhatja meg:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Minden olyan osztály, amely megvalósítja az interfészt IList

• Bármely osztály

A sztring Binding létrehozásával kapcsolatos további információkért tekintse meg az osztályt dataMember .

Amikor kötést hoz létre egy vezérlő tulajdonságához, az új Binding a kötött vezérlőelem által közzétett eseményeket vizsgálja, és két konkrét eseményhez csatolja:

• Control.Validating.

• TulajdonságnévChanged nevű esemény (például Control.BackColorChanged)

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

Forrás:

Binding.cs

Inicializálja annak az osztálynak az Binding új példányát, amely a megadott vezérlőtulajdonságot a megadott adatforrás megadott adateleméhez köti. Opcionálisan engedélyezi a formázást, propagálja az értékeket az adatforrásba a megadott frissítési beállítás alapján, és a tulajdonságot a megadott értékre állítja, amikor az adatforrásból visszaad egy DBNull értéket.

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)

Paraméterek

propertyName

String

A kötéshez tartozó vezérlőtulajdonság neve.

dataSource

Object

Az Object adatforrást jelképező.

dataMember

String

Az a tulajdonság vagy lista, amelyhez csatlakozni szeretne.

formattingEnabled

Boolean

truea megjelenített adatok formázása; egyéb esetben. false

dataSourceUpdateMode

DataSourceUpdateMode

Az egyik DataSourceUpdateMode érték.

nullValue

Object

A Object kötött vezérlőelem tulajdonságra alkalmazni kívánt érték, ha az adatforrás értéke .DBNull

Kivételek

ArgumentException

Az általa propertyName megadott tulajdonság nem létezik a vezérlőn.

-vagy-

A megadott adatforrás, adattag vagy vezérlőtulajdonság a gyűjtemény egy másik kötéséhez van társítva.

Megjegyzések

Az adatforráshoz az alábbi osztályok bármelyikének egy példányát adhatja meg:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Minden olyan osztály, amely megvalósítja az interfészt IList

• Bármely osztály

A sztring Binding létrehozásával kapcsolatos további információkért tekintse meg az osztályt dataMember .

Amikor kötést hoz létre egy vezérlő tulajdonságához, az új Binding a kötött vezérlőelem által közzétett eseményeket vizsgálja, és két konkrét eseményhez csatolja:

• Control.Validating

• TulajdonságnévChanged nevű esemény (például Control.BackColorChanged)

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

Forrás:

Binding.cs

Inicializálja annak az osztálynak az Binding új példányát, amely a megadott vezérlőtulajdonságot a megadott adatforrás megadott adateleméhez köti. Opcionálisan engedélyezi a megadott formázási sztringdel való formázást; a megadott frissítési beállítás alapján propagálja az értékeket az adatforrásba; és beállítja a tulajdonságot a megadott értékre, amikor az adatforrásból ad vissza egy DBNull értéket.

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)

Paraméterek

propertyName

String

A kötéshez tartozó vezérlőtulajdonság neve.

dataSource

Object

Az Object adatforrást jelképező.

dataMember

String

Az a tulajdonság vagy lista, amelyhez csatlakozni szeretne.

formattingEnabled

Boolean

truea megjelenített adatok formázása; egyéb esetben. false

dataSourceUpdateMode

DataSourceUpdateMode

Az egyik DataSourceUpdateMode érték.

nullValue

Object

A Object kötött vezérlőelem tulajdonságra alkalmazni kívánt érték, ha az adatforrás értéke .DBNull

formatString

String

Egy vagy több formátumjelölő karakter, amely jelzi az érték megjelenítésének módját.

Kivételek

ArgumentException

Az általa propertyName megadott tulajdonság nem létezik a vezérlőn.

-vagy-

A megadott adatforrás, adattag vagy vezérlőtulajdonság a gyűjtemény egy másik kötéséhez van társítva.

Megjegyzések

Az adatforráshoz az alábbi osztályok bármelyikének egy példányát adhatja meg:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Minden olyan osztály, amely megvalósítja az interfészt IList

• Bármely osztály

A sztring Binding létrehozásával kapcsolatos további információkért tekintse meg az osztályt dataMember .

Amikor kötést hoz létre egy vezérlő tulajdonságához, az új Binding a kötött vezérlőelem által közzétett eseményeket vizsgálja, és két konkrét eseményhez csatolja:

• Control.Validating

• TulajdonságnévChanged nevű esemény (például Control.BackColorChanged)

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

Forrás:

Binding.cs

Inicializálja az Binding osztály új példányát a megadott vezérlőtulajdonság használatával a megadott adatforrás megadott adattagjára. Opcionálisan engedélyezi a megadott formázási sztringdel való formázást; a megadott frissítési beállítás alapján propagálja az értékeket az adatforrásba; engedélyezi a formázást a megadott formátumsztringgel; a tulajdonságot a megadott értékre állítja, amikor az adatforrásból ad vissza egy DBNull értéket, és beállítja a megadott formátumszolgáltatót.

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)

Paraméterek

propertyName

String

A kötéshez tartozó vezérlőtulajdonság neve.

dataSource

Object

Az Object adatforrást jelképező.

dataMember

String

Az a tulajdonság vagy lista, amelyhez csatlakozni szeretne.

formattingEnabled

Boolean

truea megjelenített adatok formázása; egyéb esetben. false

dataSourceUpdateMode

DataSourceUpdateMode

Az egyik DataSourceUpdateMode érték.

nullValue

Object

A Object kötött vezérlőelem tulajdonságra alkalmazni kívánt érték, ha az adatforrás értéke .DBNull

formatString

String

Egy vagy több formátumjelölő karakter, amely jelzi az érték megjelenítésének módját.

formatInfo

IFormatProvider

Az alapértelmezett formázási viselkedés felülbírálásának IFormatProvider implementációja.

Kivételek

ArgumentException

Az általa propertyName megadott tulajdonság nem létezik a vezérlőn.

-vagy-

A megadott adatforrás, adattag vagy vezérlőtulajdonság a gyűjtemény egy másik kötéséhez van társítva.

Megjegyzések

Az adatforráshoz az alábbi osztályok bármelyikének egy példányát adhatja meg:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Minden olyan osztály, amely megvalósítja az interfészt IList

• Bármely osztály

A sztring Binding létrehozásával kapcsolatos további információkért tekintse meg az osztályt dataMember .

Amikor kötést hoz létre egy vezérlő tulajdonságához, az új Binding a kötött vezérlőelem által közzétett eseményeket vizsgálja, és két konkrét eseményhez csatolja:

• Control.Validating

• TulajdonságnévChanged nevű esemény (például Control.BackColorChanged)