Binding Constructors
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Initialiseert een nieuw exemplaar van de Binding klasse.
Overloads
| Name | Description |
|---|---|
| Binding(String, Object, String) |
Initialiseert een nieuw exemplaar van de Binding klasse waarmee de aangegeven besturingselementeigenschap eenvoudig wordt gekoppeld aan het opgegeven gegevenslid van de gegevensbron. |
| Binding(String, Object, String, Boolean) |
Initialiseert een nieuw exemplaar van de Binding klasse waarmee de aangegeven besturingselementeigenschap wordt gekoppeld aan het opgegeven gegevenslid van de gegevensbron. Optioneel kan opmaak worden toegepast. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode) |
Initialiseert een nieuw exemplaar van de Binding klasse waarmee de opgegeven besturingselementeigenschap wordt gekoppeld aan het opgegeven gegevenslid van de opgegeven gegevensbron. Optioneel schakelt u opmaak in en geeft u waarden door aan de gegevensbron op basis van de opgegeven update-instelling. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object) |
Initialiseert een nieuw exemplaar van de Binding klasse waarmee de aangegeven besturingselementeigenschap wordt gekoppeld aan het opgegeven gegevenslid van de opgegeven gegevensbron. U kunt desgewenst opmaak inschakelen, waarden doorgeven aan de gegevensbron op basis van de opgegeven update-instelling en de eigenschap instellen op de opgegeven waarde wanneer een DBNull waarde wordt geretourneerd uit de gegevensbron. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String) |
Initialiseert een nieuw exemplaar van de Binding klasse waarmee de opgegeven besturingselementeigenschap wordt gekoppeld aan het opgegeven gegevenslid van de opgegeven gegevensbron. Hiermee kunt u desgewenst opmaak met de opgegeven notatietekenreeks inschakelen; waarden doorgeven aan de gegevensbron op basis van de opgegeven update-instelling; en stelt de eigenschap in op de opgegeven waarde wanneer een DBNull waarde wordt geretourneerd uit de gegevensbron. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider) |
Initialiseert een nieuw exemplaar van de Binding klasse met de opgegeven besturingselementeigenschap voor het opgegeven gegevenslid van de opgegeven gegevensbron. Hiermee kunt u desgewenst opmaak met de opgegeven notatietekenreeks inschakelen; waarden doorgeven aan de gegevensbron op basis van de opgegeven update-instelling; maakt opmaak mogelijk met de opgegeven notatietekenreeks; stelt de eigenschap in op de opgegeven waarde wanneer een DBNull waarde wordt geretourneerd uit de gegevensbron en stelt de opgegeven indelingsprovider in. |
Binding(String, Object, String)
Initialiseert een nieuw exemplaar van de Binding klasse waarmee de aangegeven besturingselementeigenschap eenvoudig wordt gekoppeld aan het opgegeven gegevenslid van de gegevensbron.
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.BindingPublic Sub New (propertyName As String, dataSource As Object, dataMember As String)Parameters
- propertyName
- String
De naam van de besturingselementeigenschap die moet worden gekoppeld.
- dataMember
- String
De eigenschap of lijst waaraan moet worden gekoppeld.
Uitzonderingen
propertyName is geen geldige eigenschap van een besturingselement of een lege tekenreeks ("").
De eigenschap die wordt opgegeven door propertyName , bestaat niet in het besturingselement.
Voorbeelden
In het volgende codevoorbeeld wordt een TextBox besturingselement gekoppeld aan een tabelkolom in een DataSet benoemde myDataSetkolom. Voor het voorbeeld moet u de declaratiesectie van de module hebben gedeclareerd 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
Opmerkingen
U kunt een exemplaar van een van de volgende klassen opgeven voor de gegevensbron:
Elke klasse die de IList interface implementeert
Elke klasse
Zie de Binding klasse voor meer informatie over het maken van de dataMember tekenreeks.
Wanneer u een binding maakt met de eigenschap van een besturingselement, inspecteert het nieuwe Binding de gebeurtenissen die worden weergegeven door het afhankelijke besturingselement en koppelt deze aan twee specifieke gebeurtenissen:
Een gebeurtenis met de naam PropertyName
Changed(bijvoorbeeld Control.BackColorChanged)
Als u probeert verbinding te maken met een eigenschap die niet bestaat, wordt er een ArgumentException gegenereerd wanneer de eigenschap wordt toegevoegd aan de Binding verzameling van Control.DataBindings het besturingselement.
Zie ook
Van toepassing op
Binding(String, Object, String, Boolean)
Initialiseert een nieuw exemplaar van de Binding klasse waarmee de aangegeven besturingselementeigenschap wordt gekoppeld aan het opgegeven gegevenslid van de gegevensbron. Optioneel kan opmaak worden toegepast.
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.BindingPublic Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean)Parameters
- propertyName
- String
De naam van de besturingselementeigenschap die moet worden gekoppeld.
- dataMember
- String
De eigenschap of lijst waaraan moet worden gekoppeld.
- formattingEnabled
- Boolean
true om de weergegeven gegevens op te maken; anders, false.
Uitzonderingen
De eigenschap die wordt opgegeven door propertyName , bestaat niet in het besturingselement.
– of –
De opgegeven eigenschap is een alleen-lezen eigenschap.
Opmaak is uitgeschakeld en propertyName is geen geldige eigenschap van een besturingselement of een lege tekenreeks ("").
Van toepassing op
Binding(String, Object, String, Boolean, DataSourceUpdateMode)
Initialiseert een nieuw exemplaar van de Binding klasse waarmee de opgegeven besturingselementeigenschap wordt gekoppeld aan het opgegeven gegevenslid van de opgegeven gegevensbron. Optioneel schakelt u opmaak in en geeft u waarden door aan de gegevensbron op basis van de opgegeven update-instelling.
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.BindingPublic Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode)Parameters
- propertyName
- String
De naam van de besturingselementeigenschap die moet worden gekoppeld.
- dataMember
- String
De eigenschap of lijst waaraan moet worden gekoppeld.
- formattingEnabled
- Boolean
true om de weergegeven gegevens op te maken; anders, false.
- dataSourceUpdateMode
- DataSourceUpdateMode
Een van de DataSourceUpdateMode waarden.
Uitzonderingen
De eigenschap die wordt opgegeven door propertyName , bestaat niet in het besturingselement.
– of –
De opgegeven gegevensbron of gegevensbron of besturingselementeigenschap is gekoppeld aan een andere binding in de verzameling.
Opmerkingen
U kunt een exemplaar van een van de volgende klassen opgeven voor de gegevensbron:
Elke klasse die de IList interface implementeert
Elke klasse
Zie de Binding klasse voor meer informatie over het maken van de dataMember tekenreeks.
Wanneer u een binding maakt met de eigenschap van een besturingselement, inspecteert het nieuwe Binding de gebeurtenissen die worden weergegeven door het afhankelijke besturingselement en koppelt deze aan twee specifieke gebeurtenissen:
Een gebeurtenis met de naam PropertyName
Changed(bijvoorbeeld Control.BackColorChanged)
Van toepassing op
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)
Initialiseert een nieuw exemplaar van de Binding klasse waarmee de aangegeven besturingselementeigenschap wordt gekoppeld aan het opgegeven gegevenslid van de opgegeven gegevensbron. U kunt desgewenst opmaak inschakelen, waarden doorgeven aan de gegevensbron op basis van de opgegeven update-instelling en de eigenschap instellen op de opgegeven waarde wanneer een DBNull waarde wordt geretourneerd uit de gegevensbron.
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.BindingPublic Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object)Parameters
- propertyName
- String
De naam van de besturingselementeigenschap die moet worden gekoppeld.
- dataMember
- String
De eigenschap of lijst waaraan moet worden gekoppeld.
- formattingEnabled
- Boolean
true om de weergegeven gegevens op te maken; anders, false.
- dataSourceUpdateMode
- DataSourceUpdateMode
Een van de DataSourceUpdateMode waarden.
- nullValue
- Object
De Object waarde die moet worden toegepast op de afhankelijke besturingselementeigenschap als de gegevensbronwaarde is DBNull.
Uitzonderingen
De eigenschap die wordt opgegeven door propertyName , bestaat niet in het besturingselement.
– of –
De opgegeven gegevensbron of gegevensbron of besturingselementeigenschap is gekoppeld aan een andere binding in de verzameling.
Opmerkingen
U kunt een exemplaar van een van de volgende klassen opgeven voor de gegevensbron:
Elke klasse die de IList interface implementeert
Elke klasse
Zie de Binding klasse voor meer informatie over het maken van de dataMember tekenreeks.
Wanneer u een binding maakt met de eigenschap van een besturingselement, inspecteert het nieuwe Binding de gebeurtenissen die worden weergegeven door het afhankelijke besturingselement en koppelt deze aan twee specifieke gebeurtenissen:
Een gebeurtenis met de naam PropertyName
Changed(bijvoorbeeld Control.BackColorChanged)
Van toepassing op
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)
Initialiseert een nieuw exemplaar van de Binding klasse waarmee de opgegeven besturingselementeigenschap wordt gekoppeld aan het opgegeven gegevenslid van de opgegeven gegevensbron. Hiermee kunt u desgewenst opmaak met de opgegeven notatietekenreeks inschakelen; waarden doorgeven aan de gegevensbron op basis van de opgegeven update-instelling; en stelt de eigenschap in op de opgegeven waarde wanneer een DBNull waarde wordt geretourneerd uit de gegevensbron.
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.BindingPublic Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object, formatString As String)Parameters
- propertyName
- String
De naam van de besturingselementeigenschap die moet worden gekoppeld.
- dataMember
- String
De eigenschap of lijst waaraan moet worden gekoppeld.
- formattingEnabled
- Boolean
true om de weergegeven gegevens op te maken; anders, false.
- dataSourceUpdateMode
- DataSourceUpdateMode
Een van de DataSourceUpdateMode waarden.
- nullValue
- Object
De Object waarde die moet worden toegepast op de afhankelijke besturingselementeigenschap als de gegevensbronwaarde is DBNull.
- formatString
- String
Een of meer notatieaanduidingstekens die aangeven hoe een waarde moet worden weergegeven.
Uitzonderingen
De eigenschap die wordt opgegeven door propertyName , bestaat niet in het besturingselement.
– of –
De opgegeven gegevensbron of gegevensbron of besturingselementeigenschap is gekoppeld aan een andere binding in de verzameling.
Opmerkingen
U kunt een exemplaar van een van de volgende klassen opgeven voor de gegevensbron:
Elke klasse die de IList interface implementeert
Elke klasse
Zie de Binding klasse voor meer informatie over het maken van de dataMember tekenreeks.
Wanneer u een binding maakt met de eigenschap van een besturingselement, inspecteert het nieuwe Binding de gebeurtenissen die worden weergegeven door het afhankelijke besturingselement en koppelt deze aan twee specifieke gebeurtenissen:
Een gebeurtenis met de naam PropertyName
Changed(bijvoorbeeld Control.BackColorChanged)
Van toepassing op
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)
Initialiseert een nieuw exemplaar van de Binding klasse met de opgegeven besturingselementeigenschap voor het opgegeven gegevenslid van de opgegeven gegevensbron. Hiermee kunt u desgewenst opmaak met de opgegeven notatietekenreeks inschakelen; waarden doorgeven aan de gegevensbron op basis van de opgegeven update-instelling; maakt opmaak mogelijk met de opgegeven notatietekenreeks; stelt de eigenschap in op de opgegeven waarde wanneer een DBNull waarde wordt geretourneerd uit de gegevensbron en stelt de opgegeven indelingsprovider in.
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.BindingPublic 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)Parameters
- propertyName
- String
De naam van de besturingselementeigenschap die moet worden gekoppeld.
- dataMember
- String
De eigenschap of lijst waaraan moet worden gekoppeld.
- formattingEnabled
- Boolean
true om de weergegeven gegevens op te maken; anders, false.
- dataSourceUpdateMode
- DataSourceUpdateMode
Een van de DataSourceUpdateMode waarden.
- nullValue
- Object
De Object waarde die moet worden toegepast op de afhankelijke besturingselementeigenschap als de gegevensbronwaarde is DBNull.
- formatString
- String
Een of meer notatieaanduidingstekens die aangeven hoe een waarde moet worden weergegeven.
- formatInfo
- IFormatProvider
Een implementatie van het negeren van IFormatProvider standaardopmaakgedrag.
Uitzonderingen
De eigenschap die wordt opgegeven door propertyName , bestaat niet in het besturingselement.
– of –
De opgegeven gegevensbron of gegevensbron of besturingselementeigenschap is gekoppeld aan een andere binding in de verzameling.
Opmerkingen
U kunt een exemplaar van een van de volgende klassen opgeven voor de gegevensbron:
Elke klasse die de IList interface implementeert
Elke klasse
Zie de Binding klasse voor meer informatie over het maken van de dataMember tekenreeks.
Wanneer u een binding maakt met de eigenschap van een besturingselement, inspecteert het nieuwe Binding de gebeurtenissen die worden weergegeven door het afhankelijke besturingselement en koppelt deze aan twee specifieke gebeurtenissen:
Een gebeurtenis met de naam PropertyName
Changed(bijvoorbeeld Control.BackColorChanged)