Binding Costruttori

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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

Public Sub New (propertyName As String, dataSource As Object, dataMember As String)

Parametri

propertyName: String

Nome della proprietà del controllo da associare.

dataSource: Object

Oggetto Object che rappresenta l'origine dati.

dataMember: String

Proprietà o elenco a cui eseguire l'associazione.

Eccezioni

Exception

propertyName non corrisponde a una proprietà valida di un controllo né a una stringa vuota ("").

ArgumentException

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:

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

Control.Validating
Evento denominato PropertyNameChanged (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.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean)

Parametri

propertyName: String

Nome della proprietà del controllo da associare.

dataSource: Object

Oggetto Object che rappresenta l'origine dati.

dataMember: String

Proprietà o elenco a cui eseguire l'associazione.

formattingEnabled: Boolean

true per formattare i dati visualizzati; in caso contrario, false.

Eccezioni

ArgumentException

La proprietà specificata da propertyName non esiste nel controllo.

-oppure-

La proprietà specificata è di sola lettura.

Exception

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

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

dataSource: Object

Oggetto Object che rappresenta l'origine dati.

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

ArgumentException

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:

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

Control.Validating.
Evento denominato PropertyNameChanged (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.Binding

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

dataSource: Object

Oggetto Object che rappresenta l'origine dati.

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

ArgumentException

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:

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

Control.Validating
Evento denominato PropertyNameChanged (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.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)

Parametri

propertyName: String

Nome della proprietà del controllo da associare.

dataSource: Object

Oggetto Object che rappresenta l'origine dati.

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

ArgumentException

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:

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

Control.Validating
Evento denominato PropertyNameChanged (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.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)

Parametri

propertyName: String

Nome della proprietà del controllo da associare.

dataSource: Object

Oggetto Object che rappresenta l'origine dati.

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

ArgumentException

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:

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

Control.Validating
Evento denominato PropertyNameChanged (ad esempio, Control.BackColorChanged)

Si applica a

Condividi tramite

Binding Costruttori

Definizione

Overload

Binding(String, Object, String)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Binding(String, Object, String, Boolean)

Parametri

Eccezioni

Si applica a

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

Parametri

Eccezioni

Commenti

Si applica a

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

Parametri

Eccezioni

Commenti

Si applica a

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

Parametri

Eccezioni

Commenti

Si applica a

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

Parametri

Eccezioni

Commenti

Si applica a

Risorse aggiuntive