Binding Konstruktory

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Inicjuje nowe wystąpienie klasy Binding.

Przeciążenia

Binding(String, Object, String)	Inicjuje Binding nowe wystąpienie klasy, która łączy wskazaną właściwość kontrolki z określonym elementem członkowskim danych źródła danych.
Binding(String, Object, String, Boolean)	Inicjuje Binding nowe wystąpienie klasy, która wiąże wskazaną właściwość kontrolki z określonym elementem członkowskim danych źródła danych i opcjonalnie umożliwia zastosowanie formatowania.
Binding(String, Object, String, Boolean, DataSourceUpdateMode)	Inicjuje Binding nowe wystąpienie klasy, która wiąże określoną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych. Opcjonalnie umożliwia formatowanie i propagację wartości do źródła danych na podstawie określonego ustawienia aktualizacji.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Inicjuje Binding nowe wystąpienie klasy, która wiąże wskazaną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych. Opcjonalnie umożliwia formatowanie, propaguje wartości do źródła danych na podstawie określonego ustawienia aktualizacji i ustawia właściwość na określoną wartość DBNull po powrocie ze źródła danych.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Inicjuje Binding nowe wystąpienie klasy, która wiąże określoną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych. Opcjonalnie umożliwia formatowanie za pomocą określonego ciągu formatu; propaguje wartości do źródła danych na podstawie określonego ustawienia aktualizacji; i ustawia właściwość na określoną wartość, gdy DBNull element jest zwracany ze źródła danych.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Inicjuje nowe wystąpienie Binding klasy z określoną właściwością kontrolki do określonego elementu członkowskiego danych określonego źródła danych. Opcjonalnie umożliwia formatowanie za pomocą określonego ciągu formatu; propaguje wartości do źródła danych na podstawie określonego ustawienia aktualizacji; włącza formatowanie za pomocą określonego ciągu formatu; Ustawia właściwość na określoną wartość, gdy DBNull element jest zwracany ze źródła danych, i ustawia określonego dostawcę formatu.

Binding(String, Object, String)

Inicjuje Binding nowe wystąpienie klasy, która łączy wskazaną właściwość kontrolki z określonym elementem członkowskim danych źródła danych.

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)

Parametry

propertyName

String

Nazwa właściwości kontrolki do powiązania.

dataSource

Object

Element Object reprezentujący źródło danych.

dataMember

String

Właściwość lub lista do powiązania.

Wyjątki

Exception

propertyName nie jest prawidłową właściwością kontrolki ani pustym ciągiem ("").

ArgumentException

Właściwość podana przez propertyName nie istnieje w kontrolce.

Przykłady

Poniższy przykład kodu wiąże kontrolkę TextBox z kolumną tabeli w DataSet nazwie myDataSet. Przykład wymaga zadeklarowania myDataSet w sekcji deklaracji modułu.

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

Uwagi

Możesz określić wystąpienie dowolnej z następujących klas dla źródła danych:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Dowolna klasa, która implementuje IList interfejs

• Dowolna klasa

Zobacz klasę, Binding aby uzyskać więcej informacji na temat tworzenia dataMember ciągu.

Po utworzeniu powiązania z właściwością kontrolki nowa Binding funkcja sprawdza zdarzenia uwidocznione przez powiązaną kontrolkę i dołącza do dwóch określonych zdarzeń:

• Control.Validating

• Zdarzenie o nazwie PropertyNameChanged (na przykład Control.BackColorChanged)

Jeśli próbujesz powiązać z właściwością, która nie istnieje, ArgumentException zostanie zgłoszony po Binding dodaniu elementu do kolekcji kontrolki Control.DataBindings .

Zobacz też

• BindingsCollection
• CurrencyManager

Binding(String, Object, String, Boolean)

Inicjuje Binding nowe wystąpienie klasy, która wiąże wskazaną właściwość kontrolki z określonym elementem członkowskim danych źródła danych i opcjonalnie umożliwia zastosowanie formatowania.

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)

Parametry

propertyName

String

Nazwa właściwości kontrolki do powiązania.

dataSource

Object

Element Object reprezentujący źródło danych.

dataMember

String

Właściwość lub lista do powiązania.

formattingEnabled

Boolean

true aby sformatować wyświetlane dane; w przeciwnym razie , false.

Wyjątki

ArgumentException

Właściwość podana przez propertyName nie istnieje w kontrolce.

-lub-

Podana właściwość jest właściwością tylko do odczytu.

Exception

Formatowanie jest wyłączone i propertyName nie jest prawidłową właściwością kontrolki ani pustym ciągiem ("").

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

Inicjuje Binding nowe wystąpienie klasy, która wiąże określoną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych. Opcjonalnie umożliwia formatowanie i propagację wartości do źródła danych na podstawie określonego ustawienia aktualizacji.

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)

Parametry

propertyName

String

Nazwa właściwości kontrolki do powiązania.

dataSource

Object

Reprezentująca Object źródło danych.

dataMember

String

Właściwość lub lista do powiązania.

formattingEnabled

Boolean

true aby sformatować wyświetlane dane; w przeciwnym razie , false.

dataSourceUpdateMode

DataSourceUpdateMode

Jedna z DataSourceUpdateMode wartości.

Wyjątki

ArgumentException

Właściwość podana przez propertyName nie istnieje w kontrolce.

-lub-

Określone źródło danych lub element członkowski danych lub właściwość kontrolki są skojarzone z innym powiązaniem w kolekcji.

Uwagi

Możesz określić wystąpienie dowolnej z następujących klas dla źródła danych:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Dowolna klasa, która implementuje IList interfejs

• Dowolna klasa

Zobacz klasę, Binding aby uzyskać więcej informacji na temat tworzenia dataMember ciągu.

Po utworzeniu powiązania z właściwością kontrolki nowa Binding funkcja sprawdza zdarzenia uwidocznione przez powiązaną kontrolkę i dołącza do dwóch określonych zdarzeń:

• Control.Validating.

• Zdarzenie o nazwie PropertyNameChanged (na przykład Control.BackColorChanged)

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

Inicjuje Binding nowe wystąpienie klasy, która wiąże wskazaną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych. Opcjonalnie umożliwia formatowanie, propaguje wartości do źródła danych na podstawie określonego ustawienia aktualizacji i ustawia właściwość na określoną wartość DBNull po powrocie ze źródła danych.

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)

Parametry

propertyName

String

Nazwa właściwości kontrolki do powiązania.

dataSource

Object

Reprezentująca Object źródło danych.

dataMember

String

Właściwość lub lista do powiązania.

formattingEnabled

Boolean

true aby sformatować wyświetlane dane; w przeciwnym razie , false.

dataSourceUpdateMode

DataSourceUpdateMode

Jedna z DataSourceUpdateMode wartości.

nullValue

Object

Właściwość Object , która ma zostać zastosowana do właściwości powiązanej kontrolki, jeśli wartość źródła danych to DBNull.

Wyjątki

ArgumentException

Właściwość podana przez propertyName nie istnieje w kontrolce.

-lub-

Określone źródło danych lub element członkowski danych lub właściwość kontrolki są skojarzone z innym powiązaniem w kolekcji.

Uwagi

Możesz określić wystąpienie dowolnej z następujących klas dla źródła danych:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Dowolna klasa, która implementuje IList interfejs

• Dowolna klasa

Zobacz klasę, Binding aby uzyskać więcej informacji na temat tworzenia dataMember ciągu.

Po utworzeniu powiązania z właściwością kontrolki nowa Binding funkcja sprawdza zdarzenia uwidocznione przez powiązaną kontrolkę i dołącza do dwóch określonych zdarzeń:

• Control.Validating

• Zdarzenie o nazwie PropertyNameChanged (na przykład Control.BackColorChanged)

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

Inicjuje Binding nowe wystąpienie klasy, która wiąże określoną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych. Opcjonalnie umożliwia formatowanie za pomocą określonego ciągu formatu; propaguje wartości do źródła danych na podstawie określonego ustawienia aktualizacji; i ustawia właściwość na określoną wartość, gdy DBNull element jest zwracany ze źródła danych.

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)

Parametry

propertyName

String

Nazwa właściwości kontrolki do powiązania.

dataSource

Object

Reprezentująca Object źródło danych.

dataMember

String

Właściwość lub lista do powiązania.

formattingEnabled

Boolean

true aby sformatować wyświetlane dane; w przeciwnym razie , false.

dataSourceUpdateMode

DataSourceUpdateMode

Jedna z DataSourceUpdateMode wartości.

nullValue

Object

Właściwość Object , która ma zostać zastosowana do właściwości powiązanej kontrolki, jeśli wartość źródła danych to DBNull.

formatString

String

Co najmniej jeden znak specyfikatora formatu wskazujący sposób wyświetlania wartości.

Wyjątki

ArgumentException

Właściwość podana przez propertyName nie istnieje w kontrolce.

-lub-

Określone źródło danych lub element członkowski danych lub właściwość kontrolki są skojarzone z innym powiązaniem w kolekcji.

Uwagi

Możesz określić wystąpienie dowolnej z następujących klas dla źródła danych:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Dowolna klasa, która implementuje IList interfejs

• Dowolna klasa

Zobacz klasę, Binding aby uzyskać więcej informacji na temat tworzenia dataMember ciągu.

Po utworzeniu powiązania z właściwością kontrolki nowa Binding funkcja sprawdza zdarzenia uwidocznione przez powiązaną kontrolkę i dołącza do dwóch określonych zdarzeń:

• Control.Validating

• Zdarzenie o nazwie PropertyNameChanged (na przykład Control.BackColorChanged)

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

Inicjuje nowe wystąpienie Binding klasy z określoną właściwością kontrolki do określonego elementu członkowskiego danych określonego źródła danych. Opcjonalnie umożliwia formatowanie przy użyciu określonego ciągu formatu; propaguje wartości do źródła danych na podstawie określonego ustawienia aktualizacji; umożliwia formatowanie przy użyciu określonego ciągu formatu; Ustawia właściwość na określoną wartość, gdy DBNull obiekt jest zwracany ze źródła danych i ustawia określonego dostawcę formatu.

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)

Parametry

propertyName

String

Nazwa właściwości kontrolki, która ma być powiązana.

dataSource

Object

Element Object reprezentujący źródło danych.

dataMember

String

Właściwość lub lista, z która ma być powiązana.

formattingEnabled

Boolean

true w celu sformatowania wyświetlanych danych; w przeciwnym razie , false.

dataSourceUpdateMode

DataSourceUpdateMode

DataSourceUpdateMode Jedna z wartości.

nullValue

Object

Właściwość , która ma zostać zastosowana Object do powiązanej kontrolki, jeśli wartość źródła danych to DBNull.

formatString

String

Co najmniej jeden znak specyfikatora formatu wskazujący sposób wyświetlania wartości.

formatInfo

IFormatProvider

Implementacja w celu zastąpienia domyślnego IFormatProvider zachowania formatowania.

Wyjątki

ArgumentException

Właściwość podana przez propertyName nie istnieje w kontrolce.

-lub-

Określone źródło danych lub element członkowski lub właściwość kontrolki są skojarzone z innym powiązaniem w kolekcji.

Uwagi

Dla źródła danych można określić wystąpienie dowolnej z następujących klas:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Dowolna klasa, która implementuje IList interfejs

• Dowolna klasa

Zobacz klasę, Binding aby uzyskać więcej informacji na temat tworzenia dataMember ciągu.

Po utworzeniu powiązania z właściwością kontrolki nowa Binding funkcja sprawdza zdarzenia uwidocznione przez powiązaną kontrolkę i dołącza do dwóch określonych zdarzeń:

• Control.Validating

• Zdarzenie o nazwie PropertyNameChanged (na przykład Control.BackColorChanged)