Binding Konstruktory

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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);

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ż

Dotyczy

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);

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 ("").

Dotyczy

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

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)

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)

Dotyczy

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);

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)

Dotyczy

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);

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)

Dotyczy

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);

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)

Dotyczy

Udostępnij za pośrednictwem

Binding Konstruktory

Definicja

Przeciążenia

Binding(String, Object, String)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Binding(String, Object, String, Boolean)

Parametry

Wyjątki

Dotyczy

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

Parametry

Wyjątki

Uwagi

Dotyczy

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

Parametry

Wyjątki

Uwagi

Dotyczy

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

Parametry

Wyjątki

Uwagi

Dotyczy

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

Parametry

Wyjątki

Uwagi

Dotyczy

Dodatkowe zasoby