Binding Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inizializza una nuova istanza della classe Binding.
Overload
| Binding(String, Object, String) |
Inizializza una nuova istanza della classe Binding che stabilisce un'associazione semplice tra la proprietà del controllo indicata e il membro dati specificato dell'origine dati. |
| Binding(String, Object, String, Boolean) |
Inizializza una nuova istanza della classe Binding che stabilisce un'associazione tra la proprietà del controllo indicata e il membro dati specificato dell'origine dati, consentendo inoltre l'applicazione della formattazione, se richiesta. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode) |
Inizializza una nuova istanza della classe Binding che stabilisce un'associazione semplice tra la proprietà del controllo specificato e il membro dati specificato dell'origine dati specificata. Se richiesto, consente la formattazione e la propagazione dei valori nell'origine dati in base all'impostazione di aggiornamento specificata. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object) |
Inizializza una nuova istanza della classe Binding che stabilisce un'associazione tra la proprietà del controllo e il membro dati specificati dell'origine dati indicata. Se richiesto, abilita la formattazione, propaga i valori nell'origine dati in base all'impostazione di aggiornamento specificata e imposta la proprietà sul valore specificato quando l'origine dati restituisce DBNull. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String) |
Inizializza una nuova istanza della classe Binding che stabilisce un'associazione semplice tra la proprietà del controllo specificato e il membro dati specificato dell'origine dati specificata. Se richiesto, abilita la formattazione con la stringa di formato specificata, propaga i valori nell'origine dati in base all'impostazione di aggiornamento specificata e imposta la proprietà sul valore specificato quando l'origine dati restituisce un valore DBNull. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider) |
Inizializza una nuova istanza della classe Binding con proprietà del controllo specificato sul membro dati specificato dell'origine dati specificata. Se richiesto, abilita la formattazione con la stringa di formato specificata; propaga i valori nell'origine dati in base all'impostazione di aggiornamento specificata; abilita la formattazione con la stringa di formato specificata e imposta la proprietà sul valore specificato quando l'origine dati restituisce DBNull nonché imposta il provider del formato specificato. |
Binding(String, Object, String)
Inizializza una nuova istanza della classe Binding che stabilisce un'associazione semplice tra la proprietà del controllo indicata e il membro dati specificato dell'origine dati.
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.BindingPublic Sub New (propertyName As String, dataSource As Object, dataMember As String)Parametri
- propertyName
- String
Nome della proprietà del controllo da associare.
- dataMember
- String
Proprietà o elenco a cui eseguire l'associazione.
Eccezioni
propertyName non corrisponde a una proprietà valida di un controllo né a una stringa vuota ("").
La proprietà specificata da propertyName non esiste nel controllo.
Esempio
L'esempio di codice seguente associa un TextBox controllo a una colonna di tabella in un DataSet oggetto denominato myDataSet. L'esempio richiede che sia stato dichiarato myDataSet nella sezione dichiarazioni del modulo.
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
Commenti
È possibile specificare un'istanza di una delle classi seguenti per l'origine dati:
Qualsiasi classe che implementa l'interfaccia IList
Qualsiasi classe
Per altre informazioni sulla creazione della stringa, vedere la BindingdataMember classe .
Quando si crea un'associazione alla proprietà di un controllo, la nuova Binding verifica gli eventi esposti dal controllo associato e associa a due eventi specifici:
Evento denominato PropertyName
Changed(ad esempio, Control.BackColorChanged)
Se si tenta di eseguire l'associazione a una proprietà che non esiste, verrà generata Binding una ArgumentException volta aggiunto all'insieme del Control.DataBindings controllo.
Vedi anche
Si applica a
Binding(String, Object, String, Boolean)
Inizializza una nuova istanza della classe Binding che stabilisce un'associazione tra la proprietà del controllo indicata e il membro dati specificato dell'origine dati, consentendo inoltre l'applicazione della formattazione, se richiesta.
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.BindingPublic Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean)Parametri
- propertyName
- String
Nome della proprietà del controllo da associare.
- dataMember
- String
Proprietà o elenco a cui eseguire l'associazione.
- formattingEnabled
- Boolean
true per formattare i dati visualizzati; in caso contrario, false.
Eccezioni
La proprietà specificata da propertyName non esiste nel controllo.
-oppure-
La proprietà specificata è di sola lettura.
La formattazione è disabilitata e propertyName non corrisponde a una proprietà valida di un controllo né a una stringa vuota ("").
Si applica a
Binding(String, Object, String, Boolean, DataSourceUpdateMode)
Inizializza una nuova istanza della classe Binding che stabilisce un'associazione semplice tra la proprietà del controllo specificato e il membro dati specificato dell'origine dati specificata. Se richiesto, consente la formattazione e la propagazione dei valori nell'origine dati in base all'impostazione di aggiornamento specificata.
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.BindingPublic Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode)Parametri
- propertyName
- String
Nome della proprietà del controllo da associare.
- dataMember
- String
Proprietà o elenco a cui eseguire l'associazione.
- formattingEnabled
- Boolean
true per formattare i dati visualizzati; in caso contrario, false.
- dataSourceUpdateMode
- DataSourceUpdateMode
Uno dei valori di DataSourceUpdateMode.
Eccezioni
La proprietà specificata da propertyName non esiste nel controllo.
-oppure-
La coppia origine dati o membro dati o la proprietà del controllo specificata è associata a un'altra associazione nell'insieme.
Commenti
È possibile specificare un'istanza di una delle classi seguenti per l'origine dati:
Qualsiasi classe che implementa l'interfaccia IList
Qualsiasi classe
Per altre informazioni sulla creazione della stringa, vedere la BindingdataMember classe .
Quando si crea un'associazione alla proprietà di un controllo, la nuova Binding verifica gli eventi esposti dal controllo associato e associa a due eventi specifici:
Evento denominato PropertyName
Changed(ad esempio, Control.BackColorChanged)
Si applica a
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)
Inizializza una nuova istanza della classe Binding che stabilisce un'associazione tra la proprietà del controllo e il membro dati specificati dell'origine dati indicata. Se richiesto, abilita la formattazione, propaga i valori nell'origine dati in base all'impostazione di aggiornamento specificata e imposta la proprietà sul valore specificato quando l'origine dati restituisce 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.BindingPublic Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object)Parametri
- propertyName
- String
Nome della proprietà del controllo da associare.
- dataMember
- String
Proprietà o elenco a cui eseguire l'associazione.
- formattingEnabled
- Boolean
true per formattare i dati visualizzati; in caso contrario, false.
- dataSourceUpdateMode
- DataSourceUpdateMode
Uno dei valori di DataSourceUpdateMode.
- nullValue
- Object
Oggetto Object da applicare alla proprietà del controllo associato se il valore dell'origine dati è DBNull.
Eccezioni
La proprietà specificata da propertyName non esiste nel controllo.
-oppure-
La coppia origine dati o membro dati o la proprietà del controllo specificata è associata a un'altra associazione nell'insieme.
Commenti
È possibile specificare un'istanza di una delle classi seguenti per l'origine dati:
Qualsiasi classe che implementa l'interfaccia IList
Qualsiasi classe
Per altre informazioni sulla creazione della stringa, vedere la BindingdataMember classe .
Quando si crea un'associazione alla proprietà di un controllo, la nuova Binding verifica gli eventi esposti dal controllo associato e associa a due eventi specifici:
Evento denominato PropertyName
Changed(ad esempio, Control.BackColorChanged)
Si applica a
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)
Inizializza una nuova istanza della classe Binding che stabilisce un'associazione semplice tra la proprietà del controllo specificato e il membro dati specificato dell'origine dati specificata. Se richiesto, abilita la formattazione con la stringa di formato specificata, propaga i valori nell'origine dati in base all'impostazione di aggiornamento specificata e imposta la proprietà sul valore specificato quando l'origine dati restituisce un valore DBNull.
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.BindingPublic Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object, formatString As String)Parametri
- propertyName
- String
Nome della proprietà del controllo da associare.
- dataMember
- String
Proprietà o elenco a cui eseguire l'associazione.
- formattingEnabled
- Boolean
true per formattare i dati visualizzati; in caso contrario, false.
- dataSourceUpdateMode
- DataSourceUpdateMode
Uno dei valori di DataSourceUpdateMode.
- nullValue
- Object
Oggetto Object da applicare alla proprietà del controllo associato se il valore dell'origine dati è DBNull.
- formatString
- String
Uno o più caratteri identificatori di formato che indicano il modo in cui deve essere visualizzato un valore.
Eccezioni
La proprietà specificata da propertyName non esiste nel controllo.
-oppure-
La coppia origine dati o membro dati o la proprietà del controllo specificata è associata a un'altra associazione nell'insieme.
Commenti
È possibile specificare un'istanza di una delle classi seguenti per l'origine dati:
Qualsiasi classe che implementa l'interfaccia IList
Qualsiasi classe
Per altre informazioni sulla creazione della stringa, vedere la BindingdataMember classe .
Quando si crea un'associazione alla proprietà di un controllo, la nuova Binding verifica gli eventi esposti dal controllo associato e associa a due eventi specifici:
Evento denominato PropertyName
Changed(ad esempio, Control.BackColorChanged)
Si applica a
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)
Inizializza una nuova istanza della classe Binding con proprietà del controllo specificato sul membro dati specificato dell'origine dati specificata. Se richiesto, abilita la formattazione con la stringa di formato specificata; propaga i valori nell'origine dati in base all'impostazione di aggiornamento specificata; abilita la formattazione con la stringa di formato specificata e imposta la proprietà sul valore specificato quando l'origine dati restituisce DBNull nonché imposta il provider del formato specificato.
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.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)Parametri
- propertyName
- String
Nome della proprietà del controllo da associare.
- dataMember
- String
Proprietà o elenco a cui eseguire l'associazione.
- formattingEnabled
- Boolean
true per formattare i dati visualizzati; in caso contrario, false.
- dataSourceUpdateMode
- DataSourceUpdateMode
Uno dei valori di DataSourceUpdateMode.
- nullValue
- Object
Oggetto Object da applicare alla proprietà del controllo associato se il valore dell'origine dati è DBNull.
- formatString
- String
Uno o più caratteri identificatori di formato che indicano il modo in cui deve essere visualizzato un valore.
- formatInfo
- IFormatProvider
Implementazione di IFormatProvider per eseguire l'override del comportamento predefinito della formattazione.
Eccezioni
La proprietà specificata da propertyName non esiste nel controllo.
-oppure-
La coppia origine dati o membro dati o la proprietà del controllo specificata è associata a un'altra associazione nell'insieme.
Commenti
È possibile specificare un'istanza di una delle classi seguenti per l'origine dati:
Qualsiasi classe che implementa l'interfaccia IList
Qualsiasi classe
Per altre informazioni sulla creazione della dataMember stringa, vedere la Binding classe .
Quando si crea un'associazione alla proprietà di un controllo, il nuovo Binding controlla gli eventi esposti dal controllo associato e si associa a due eventi specifici:
Evento denominato PropertyName
Changed(ad esempio, Control.BackColorChanged)
Si applica a
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per