ControlBindingsCollection.Add Metod

Definition

Namnområde:: System.Windows.Forms

Sammansättning:: System.Windows.Forms.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Lägger till en Binding i samlingen.

Överlagringar

Name	Description
Add(Binding)	Lägger till den angivna Binding i samlingen.
Add(String, Object, String)	Skapar en Binding med det angivna kontrollegenskapsnamnet, datakällan och datamedlemmen och lägger till den i samlingen.
Add(String, Object, String, Boolean)	Skapar en bindning med det angivna kontrollegenskapsnamnet, datakällan, datamedlemmen och information om huruvida formatering är aktiverat och lägger till bindningen i samlingen.
Add(String, Object, String, Boolean, DataSourceUpdateMode)	Skapar en bindning som binder den angivna kontrollegenskapen till den angivna datamedlemmen i den angivna datakällan, om du vill aktivera formatering, sprida värden till datakällan baserat på den angivna uppdateringsinställningen och lägga till bindningen i samlingen.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Skapar en bindning som binder den angivna kontrollegenskapen till den angivna datamedlemmen i den angivna datakällan, om du vill aktivera formatering, sprida värden till datakällan baserat på den angivna uppdateringsinställningen, ange egenskapen till det angivna värdet när DBNull den returneras från datakällan och lägga till bindningen i samlingen.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Skapar en bindning som binder den angivna kontrollegenskapen till den angivna datamedlemmen i den angivna datakällan, om du vill aktivera formatering med den angivna formatsträngen, sprida värden till datakällan baserat på den angivna uppdateringsinställningen, ange egenskapen till det angivna värdet när DBNull returneras från datakällan och lägga till bindningen i samlingen.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Skapar en bindning som binder den angivna kontrollegenskapen till den angivna datamedlemmen i den angivna datakällan, om du vill aktivera formatering med den angivna formatsträngen, sprida värden till datakällan baserat på den angivna uppdateringsinställningen, ange egenskapen till det angivna värdet när DBNull returneras från datakällan, ange den angivna formatprovidern. och lägger till bindningen i samlingen.

Add(Binding)

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Lägger till den angivna Binding i samlingen.

public:
 void Add(System::Windows::Forms::Binding ^ binding);

public void Add(System.Windows.Forms.Binding binding);

override this.Add : System.Windows.Forms.Binding -> unit

Public Sub Add (binding As Binding)

Parametrar

binding: Binding

Att Binding lägga till.

Undantag

ArgumentNullException

Är binding null.

ArgumentException

Kontrollegenskapen är redan databunden.

-eller-

Binding Anger inte en giltig kolumn i DataSource.

Exempel

I följande kodexempel skapas en Binding instans och metoden används Add för att lägga till instansen i ControlBindingsCollection en TextBox kontroll.

protected:
   void BindControls()
   {
      /* Create a new Binding using the DataSet and a 
         navigation path(TableName.RelationName.ColumnName).
         Add event delegates for the Parse and Format events to 
         the Binding object, and add the object to the third 
         TextBox control's BindingsCollection. The delegates 
         must be added before adding the Binding to the 
         collection; otherwise, no formatting occurs until 
         the Current object of the BindingManagerBase for 
         the data source changes. */
      Binding^ b = gcnew Binding(
         "Text",ds,"customers.custToOrders.OrderAmount" );
      b->Parse += gcnew ConvertEventHandler(
         this, &Form1::CurrencyStringToDecimal );
      b->Format += gcnew ConvertEventHandler(
         this, &Form1::DecimalToCurrencyString );
      textBox1->DataBindings->Add( b );
   }

protected void BindControls()
{
   /* Create a new Binding using the DataSet and a 
   navigation path(TableName.RelationName.ColumnName).
   Add event delegates for the Parse and Format events to 
   the Binding object, and add the object to the third 
   TextBox control's BindingsCollection. The delegates 
   must be added before adding the Binding to the 
   collection; otherwise, no formatting occurs until 
   the Current object of the BindingManagerBase for 
   the data source changes. */
   Binding b = new Binding
   ("Text", ds, "customers.custToOrders.OrderAmount");
   b.Parse+=new ConvertEventHandler(CurrencyStringToDecimal);
   b.Format+=new ConvertEventHandler(DecimalToCurrencyString);
   textBox1.DataBindings.Add(b);
}

Protected Sub BindControls()
    ' Create a new Binding using the DataSet and a 
    ' navigation path(TableName.RelationName.ColumnName).
    ' Add event delegates for the Parse and Format events to 
    ' the Binding object, and add the object to the third 
    ' TextBox control's BindingsCollection. The delegates 
    ' must be added before adding the Binding to the 
    ' collection; otherwise, no formatting occurs until 
    ' the Current object of the BindingManagerBase for 
    ' the data source changes. 
    Dim b As New Binding("Text", ds, "customers.custToOrders.OrderAmount")
    AddHandler b.Parse, AddressOf CurrencyStringToDecimal
    AddHandler b.Format, AddressOf DecimalToCurrencyString
    textBox1.DataBindings.Add(b)
End Sub

Kommentarer

Egenskapen DataSourceUpdateMode för den Binding som skapas av den här överlagringen Add av metoden anges till värdet för DefaultDataSourceUpdateMode egenskapen.

Händelsen CollectionChanged inträffar när ändringen är klar.

Gäller för

Add(String, Object, String)

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Skapar en Binding med det angivna kontrollegenskapsnamnet, datakällan och datamedlemmen och lägger till den i samlingen.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember);

public System.Windows.Forms.Binding Add(string propertyName, object dataSource, string dataMember);

public System.Windows.Forms.Binding Add(string propertyName, object dataSource, string? dataMember);

override this.Add : string * obj * string -> System.Windows.Forms.Binding

Public Function Add (propertyName As String, dataSource As Object, dataMember As String) As Binding

Parametrar

propertyName: String

Namnet på den kontrollegenskap som ska bindas.

dataSource: Object

En Object som representerar datakällan.

dataMember: String

Egenskapen eller listan som ska bindas till.

Returer

Binding

Den nyligen skapade Binding.

Undantag

ArgumentNullException

binding är null.

Exception

Är propertyName redan databunden.

-eller-

Anger dataMember inte en giltig medlem i dataSource.

Exempel

I följande kodexempel används Add metoden för att lägga till tre Binding objekt i ControlBindingsCollection en TextBox kontroll. ControlBindingsCollection Nås via DataBindings egenskapen för Control klassen.

private:
   void BindTextBoxProperties()
   {
      // Clear the collection before adding new Binding objects.
      textBox1->DataBindings->Clear();

      // Create a DataTable containing Color objects.
      DataTable^ t = MakeTable();

      /* Bind the Text, BackColor, and ForeColor properties
         to columns in the DataTable. */
      textBox1->DataBindings->Add( "Text", t, "Text" );
      textBox1->DataBindings->Add( "BackColor", t, "BackColor" );
      textBox1->DataBindings->Add( "ForeColor", t, "ForeColor" );
   }

   DataTable^ MakeTable()
   {
      /* Create a DataTable with three columns.
         Two of the columns contain Color objects. */
      DataTable^ t = gcnew DataTable( "Control" );
      t->Columns->Add( "BackColor", Color::typeid );
      t->Columns->Add( "ForeColor", Color::typeid );
      t->Columns->Add( "Text" );

      // Add three rows to the table.
      DataRow^ r;
      r = t->NewRow();
      r[ "BackColor" ] = Color::Blue;
      r[ "ForeColor" ] = Color::Yellow;
      r[ "Text" ] = "Yellow on Blue";
      t->Rows->Add( r );
      r = t->NewRow();
      r[ "BackColor" ] = Color::White;
      r[ "ForeColor" ] = Color::Green;
      r[ "Text" ] = "Green on white";
      t->Rows->Add( r );
      r = t->NewRow();
      r[ "BackColor" ] = Color::Orange;
      r[ "ForeColor" ] = Color::Black;
      r[ "Text" ] = "Black on Orange";
      t->Rows->Add( r );
      return t;
   }

private void BindTextBoxProperties()
{
   // Clear the collection before adding new Binding objects.
   textBox1.DataBindings.Clear();

   // Create a DataTable containing Color objects.
   DataTable t = MakeTable();

   /* Bind the Text, BackColor, and ForeColor properties
   to columns in the DataTable. */
   textBox1.DataBindings.Add("Text", t, "Text");
   textBox1.DataBindings.Add("BackColor", t, "BackColor");
   textBox1.DataBindings.Add("ForeColor", t, "ForeColor");
}

private DataTable MakeTable()
{
   /* Create a DataTable with three columns.
   Two of the columns contain Color objects. */

   DataTable t = new DataTable("Control");
   t.Columns.Add("BackColor", typeof(Color));
   t.Columns.Add("ForeColor", typeof(Color));
   t.Columns.Add("Text");

   // Add three rows to the table.
   DataRow r;

   r = t.NewRow();
   r["BackColor"] = Color.Blue;
   r["ForeColor"] = Color.Yellow;
   r["Text"] = "Yellow on Blue";
   t.Rows.Add(r);

   r = t.NewRow();
   r["BackColor"] = Color.White;
   r["ForeColor"] = Color.Green;
   r["Text"] = "Green on white";
   t.Rows.Add(r);

   r = t.NewRow();
   r["BackColor"] = Color.Orange;
   r["ForeColor"] = Color.Black;
   r["Text"] = "Black on Orange";
   t.Rows.Add(r);

   return t;
}

Private Sub BindTextBoxProperties()
    ' Clear the collection before adding new Binding objects.
    textBox1.DataBindings.Clear()
    
    ' Create a DataTable containing Color objects.
    Dim t As DataTable = MakeTable()
    
    ' Bind the Text, BackColor, and ForeColor properties
    ' to columns in the DataTable. 
    textBox1.DataBindings.Add("Text", t, "Text")
    textBox1.DataBindings.Add("BackColor", t, "BackColor")
    textBox1.DataBindings.Add("ForeColor", t, "ForeColor")
End Sub    

Private Function MakeTable() As DataTable
    ' Create a DataTable with three columns.
    ' Two of the columns contain Color objects. 
    
    Dim t As New DataTable("Control")
    t.Columns.Add("BackColor", GetType(Color))
    t.Columns.Add("ForeColor", GetType(Color))
    t.Columns.Add("Text")
    
    ' Add three rows to the table.
    Dim r As DataRow
    
    r = t.NewRow()
    r("BackColor") = Color.Blue
    r("ForeColor") = Color.Yellow
    r("Text") = "Yellow on Blue"
    t.Rows.Add(r)
    
    r = t.NewRow()
    r("BackColor") = Color.White
    r("ForeColor") = Color.Green
    r("Text") = "Green on white"
    t.Rows.Add(r)
    
    r = t.NewRow()
    r("BackColor") = Color.Orange
    r("ForeColor") = Color.Black
    r("Text") = "Black on Orange"
    t.Rows.Add(r)
    
    Return t
End Function

Kommentarer

Egenskapen DataSourceUpdateMode för den Binding som skapas av den här överlagringen Add av metoden anges till värdet för DefaultDataSourceUpdateMode egenskapen.

Att lägga till en Binding gör att händelsen CollectionChanged inträffar.

Gäller för

Add(String, Object, String, Boolean)

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Skapar en bindning med det angivna kontrollegenskapsnamnet, datakällan, datamedlemmen och information om huruvida formatering är aktiverat och lägger till bindningen i samlingen.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled);

public System.Windows.Forms.Binding Add(string propertyName, object dataSource, string dataMember, bool formattingEnabled);

public System.Windows.Forms.Binding Add(string propertyName, object dataSource, string? dataMember, bool formattingEnabled);

override this.Add : string * obj * string * bool -> System.Windows.Forms.Binding

Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean) As Binding

Parametrar

propertyName: String

Namnet på den kontrollegenskap som ska bindas.

dataSource: Object

En Object som representerar datakällan.

dataMember: String

Egenskapen eller listan som ska bindas till.

formattingEnabled: Boolean

trueför att formatera de data som visas. annars . false

Returer

Binding

Den nyligen skapade Binding.

Undantag

ArgumentException

Egenskapen som anges av propertyName finns inte på kontrollen.

-eller-

Den angivna egenskapen är en skrivskyddad egenskap.

Exception

Om formateringen är inaktiverad och propertyName varken är en giltig egenskap för en kontroll eller en tom sträng ("").

Gäller för

Add(String, Object, String, Boolean, DataSourceUpdateMode)

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Skapar en bindning som binder den angivna kontrollegenskapen till den angivna datamedlemmen i den angivna datakällan, om du vill aktivera formatering, sprida värden till datakällan baserat på den angivna uppdateringsinställningen och lägga till bindningen i samlingen.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode);

public System.Windows.Forms.Binding Add(string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode);

public System.Windows.Forms.Binding Add(string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode);

override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode -> System.Windows.Forms.Binding

Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode) As Binding

Parametrar

propertyName: String

Namnet på den kontrollegenskap som ska bindas.

dataSource: Object

En Object som representerar datakällan.

dataMember: String

Egenskapen eller listan som ska bindas till.

formattingEnabled: Boolean

trueför att formatera de data som visas. annars . false

updateMode: DataSourceUpdateMode

Ett av DataSourceUpdateMode värdena.

Returer

Binding

Den nyligen skapade Binding.

Undantag

ArgumentException

Egenskapen som anges av propertyName finns inte på kontrollen eller är skrivskyddad.

-eller-

Den angivna datamedlemmen finns inte i datakällan.

-eller-

Den angivna datakällan, datamedlemmen eller kontrollegenskapen är associerade med en annan bindning i samlingen.

Kommentarer

Add När du anropar metoden genereras CollectionChanged händelsen.

Gäller för

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue);

public System.Windows.Forms.Binding Add(string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue);

public System.Windows.Forms.Binding Add(string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue);

override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj -> System.Windows.Forms.Binding

Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object) As Binding

Parametrar

propertyName: String

Namnet på den kontrollegenskap som ska bindas.

dataSource: Object

En Object som representerar datakällan.

dataMember: String

Egenskapen eller listan som ska bindas till.

formattingEnabled: Boolean

trueför att formatera de data som visas. annars . false

updateMode: DataSourceUpdateMode

Ett av DataSourceUpdateMode värdena.

nullValue: Object

När datakällan har det här värdet anges den bundna egenskapen till DBNull.

Returer

Binding

Den nyligen skapade Binding.

Undantag

ArgumentException

Egenskapen som anges av propertyName finns inte på kontrollen eller är skrivskyddad.

-eller-

Den angivna datamedlemmen finns inte i datakällan.

-eller-

Den angivna datakällan, datamedlemmen eller kontrollegenskapen är associerade med en annan bindning i samlingen.

Kommentarer

Add När du anropar metoden genereras CollectionChanged händelsen.

Gäller för

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Skapar en bindning som binder den angivna kontrollegenskapen till den angivna datamedlemmen i den angivna datakällan, om du vill aktivera formatering med den angivna formatsträngen, sprida värden till datakällan baserat på den angivna uppdateringsinställningen, ange egenskapen till det angivna värdet när DBNull returneras från datakällan och lägga till bindningen i samlingen.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue, System::String ^ formatString);

public System.Windows.Forms.Binding Add(string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue, string formatString);

public System.Windows.Forms.Binding Add(string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue, string formatString);

override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string -> System.Windows.Forms.Binding

Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object, formatString As String) As Binding

Parametrar

propertyName: String

Namnet på den kontrollegenskap som ska bindas.

dataSource: Object

En Object som representerar datakällan.

dataMember: String

Egenskapen eller listan som ska bindas till.

formattingEnabled: Boolean

trueför att formatera de data som visas. annars . false

updateMode: DataSourceUpdateMode

Ett av DataSourceUpdateMode värdena.

nullValue: Object

När datakällan har det här värdet anges den bundna egenskapen till DBNull.

formatString: String

Ett eller flera formatspecificerare som anger hur ett värde ska visas.

Returer

Binding

Den nyligen skapade Binding.

Undantag

ArgumentException

Egenskapen som anges av propertyName finns inte på kontrollen eller är skrivskyddad.

-eller-

Den angivna datamedlemmen finns inte i datakällan.

-eller-

Den angivna datakällan, datamedlemmen eller kontrollegenskapen är associerade med en annan bindning i samlingen.

Kommentarer

Add När du anropar metoden genereras CollectionChanged händelsen.

Gäller för

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

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

Källa:: ControlBindingsCollection.cs

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue, System::String ^ formatString, IFormatProvider ^ formatInfo);

public System.Windows.Forms.Binding Add(string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue, string formatString, IFormatProvider formatInfo);

public System.Windows.Forms.Binding Add(string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue, string formatString, IFormatProvider? formatInfo);

override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string * IFormatProvider -> System.Windows.Forms.Binding

Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object, formatString As String, formatInfo As IFormatProvider) As Binding

Parametrar

propertyName: String

Namnet på den kontrollegenskap som ska bindas.

dataSource: Object

En Object som representerar datakällan.

dataMember: String

Egenskapen eller listan som ska bindas till.

formattingEnabled: Boolean

trueför att formatera de data som visas. annars . false

updateMode: DataSourceUpdateMode

Ett av DataSourceUpdateMode värdena.

nullValue: Object

När datakällan har det här värdet anges den bundna egenskapen till DBNull.

formatString: String

Ett eller flera formatspecificerare som anger hur ett värde ska visas.

formatInfo: IFormatProvider

En implementering av IFormatProvider för att åsidosätta standardformateringsbeteendet.

Returer

Binding

Den nyligen skapade Binding.

Undantag

ArgumentException

Egenskapen som anges av propertyName finns inte på kontrollen eller är skrivskyddad.

-eller-

Den angivna datamedlemmen finns inte i datakällan.

-eller-

Den angivna datakällan, datamedlemmen eller kontrollegenskapen är associerade med en annan bindning i samlingen.

Kommentarer

Add När du anropar metoden genereras CollectionChanged händelsen.

Gäller för

Feedback

Var den här sidan till hjälp?