ControlBindingsCollection.Add Yöntem

Tanım

Koleksiyona bir Binding ekler.

Aşırı Yüklemeler

Add(Binding)

Belirtilen Binding öğesini koleksiyona ekler.

Add(String, Object, String)

Belirtilen denetim özelliği adını, veri kaynağını ve veri üyesini kullanarak bir Binding oluşturur ve bunu koleksiyona ekler.

Add(String, Object, String, Boolean)

Belirtilen denetim özelliği adına, veri kaynağına, veri üyesine ve biçimlendirmenin etkinleştirilip etkinleştirilmediğine ilişkin bilgilere sahip bir bağlama oluşturur ve bağlamayı koleksiyona ekler.

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

Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak ve bağlamayı koleksiyona ekleyen bir bağlama oluşturur.

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

Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak, veri kaynağından döndürülürken DBNull özelliği belirtilen değere ayarlayan ve bağlamayı koleksiyona ekleyen bir bağlama oluşturur.

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

Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak belirtilen biçim dizesiyle biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak, veri kaynağından döndürülürken DBNull özelliği belirtilen değere ayarlayan ve bağlamayı koleksiyona ekleyen bir bağlama oluşturur.

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

Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak belirtilen biçim dizesiyle biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak, veri kaynağından döndürülürken DBNull özelliği belirtilen değere ayarlayan, belirtilen biçim sağlayıcısını ayarlayan bir bağlama oluşturur. ve bağlamayı koleksiyona ekler.

Add(Binding)

Belirtilen Binding öğesini koleksiyona ekler.

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)

Parametreler

binding
Binding

Binding Eklenecek.

Özel durumlar

binding null değeridir.

Denetim özelliği zaten veriye bağlı.

-veya-

geçerli Binding bir sütun DataSourcebelirtmez.

Örnekler

Aşağıdaki kod örneği bir Binding örnek oluşturur ve bir denetimin örneğine eklemek için ControlBindingsCollectionTextBox yöntemini kullanırAdd.

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

Açıklamalar

DataSourceUpdateMode yönteminin Binding bu aşırı yüklemesi tarafından oluşturulan özelliğinin Add özelliği, özelliğinin DefaultDataSourceUpdateMode değerine ayarlanır.

Değişiklik CollectionChanged tamamlandığında olay gerçekleşir.

Şunlara uygulanır

Add(String, Object, String)

Belirtilen denetim özelliği adını, veri kaynağını ve veri üyesini kullanarak bir Binding oluşturur ve bunu koleksiyona ekler.

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

Parametreler

propertyName
String

Bağlanacak denetim özelliğinin adı.

dataSource
Object

Object Veri kaynağını temsil eden bir.

dataMember
String

Bağlanacak özellik veya liste.

Döndürülenler

Yeni oluşturulan Binding.

Özel durumlar

şeklindedir bindingnull.

propertyName zaten veriye bağlıdır.

-veya-

geçerli dataMember bir üyesini dataSourcebelirtmez.

Örnekler

Aşağıdaki kod örneği, bir denetimin Add öğesine üç Binding nesne eklemek için ControlBindingsCollection yöntemini TextBox kullanır. ControlBindingsCollection öğesine sınıfının özelliği Control aracılığıyla DataBindings erişilir.

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

Açıklamalar

DataSourceUpdateMode yönteminin Binding bu aşırı yüklemesi tarafından oluşturulan özelliğinin Add özelliği, özelliğinin DefaultDataSourceUpdateMode değerine ayarlanır.

Ekleme Binding , olayın gerçekleşmesine neden olur CollectionChanged .

Şunlara uygulanır

Add(String, Object, String, Boolean)

Belirtilen denetim özelliği adına, veri kaynağına, veri üyesine ve biçimlendirmenin etkinleştirilip etkinleştirilmediğine ilişkin bilgilere sahip bir bağlama oluşturur ve bağlamayı koleksiyona ekler.

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

Parametreler

propertyName
String

Bağlanacak denetim özelliğinin adı.

dataSource
Object

Object Veri kaynağını temsil eden bir.

dataMember
String

Bağlanacak özellik veya liste.

formattingEnabled
Boolean

true görüntülenen verileri biçimlendirmek için; aksi takdirde , false.

Döndürülenler

Yeni oluşturulan Binding.

Özel durumlar

tarafından propertyName verilen özellik denetimde yok.

-veya-

Verilen özellik salt okunur bir özelliktir.

Biçimlendirme devre dışıysa ve denetimin propertyName geçerli bir özelliği değilse veya boş bir dizeyse ("").

Şunlara uygulanır

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

Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak ve bağlamayı koleksiyona ekleyen bir bağlama oluşturur.

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

Parametreler

propertyName
String

Bağlanacak denetim özelliğinin adı.

dataSource
Object

Object Veri kaynağını temsil eden bir.

dataMember
String

Bağlanacak özellik veya liste.

formattingEnabled
Boolean

true görüntülenen verileri biçimlendirmek için; aksi takdirde , false.

updateMode
DataSourceUpdateMode

Değerlerden DataSourceUpdateMode biri.

Döndürülenler

Yeni oluşturulan Binding.

Özel durumlar

tarafından propertyName verilen özellik denetimde yok veya salt okunur.

-veya-

Belirtilen veri üyesi veri kaynağında yok.

-veya-

Belirtilen veri kaynağı, veri üyesi veya denetim özelliği koleksiyondaki başka bir bağlamayla ilişkilendirilir.

Açıklamalar

yöntemini çağırmak Add olayı tetikler CollectionChanged .

Şunlara uygulanır

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

Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak, veri kaynağından döndürülürken DBNull özelliği belirtilen değere ayarlayan ve bağlamayı koleksiyona ekleyen bir bağlama oluşturur.

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

Parametreler

propertyName
String

Bağlanacak denetim özelliğinin adı.

dataSource
Object

Object Veri kaynağını temsil eden bir.

dataMember
String

Bağlanacak özellik veya liste.

formattingEnabled
Boolean

true görüntülenen verileri biçimlendirmek için; aksi takdirde , false.

updateMode
DataSourceUpdateMode

Değerlerden DataSourceUpdateMode biri.

nullValue
Object

Veri kaynağı bu değere sahip olduğunda, ilişkili özellik olarak DBNullayarlanır.

Döndürülenler

Yeni oluşturulan Binding.

Özel durumlar

tarafından propertyName verilen özellik denetimde yok veya salt okunur.

-veya-

Belirtilen veri üyesi veri kaynağında yok.

-veya-

Belirtilen veri kaynağı, veri üyesi veya denetim özelliği koleksiyondaki başka bir bağlamayla ilişkilendirilir.

Açıklamalar

yöntemini çağırmak Add olayı tetikler CollectionChanged .

Şunlara uygulanır

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

Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak belirtilen biçim dizesiyle biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak, veri kaynağından döndürülürken DBNull özelliği belirtilen değere ayarlayan ve bağlamayı koleksiyona ekleyen bir bağlama oluşturur.

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

Parametreler

propertyName
String

Bağlanacak denetim özelliğinin adı.

dataSource
Object

Object Veri kaynağını temsil eden bir.

dataMember
String

Bağlanacak özellik veya liste.

formattingEnabled
Boolean

true görüntülenen verileri biçimlendirmek için; aksi takdirde , false.

updateMode
DataSourceUpdateMode

Değerlerden DataSourceUpdateMode biri.

nullValue
Object

Veri kaynağı bu değere sahip olduğunda, ilişkili özellik olarak DBNullayarlanır.

formatString
String

Bir değerin nasıl görüntüleneceğini gösteren bir veya daha fazla biçim belirtici karakteri.

Döndürülenler

Yeni oluşturulan Binding.

Özel durumlar

tarafından propertyName verilen özellik denetimde yok veya salt okunur.

-veya-

Belirtilen veri üyesi veri kaynağında yok.

-veya-

Belirtilen veri kaynağı, veri üyesi veya denetim özelliği koleksiyondaki başka bir bağlamayla ilişkilendirilir.

Açıklamalar

yöntemini çağırmak Add olayı tetikler CollectionChanged .

Şunlara uygulanır

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

Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak belirtilen biçim dizesiyle biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak, veri kaynağından döndürülürken DBNull özelliği belirtilen değere ayarlayan, belirtilen biçim sağlayıcısını ayarlayan bir bağlama oluşturur. ve bağlamayı koleksiyona ekler.

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

Parametreler

propertyName
String

Bağlanacak denetim özelliğinin adı.

dataSource
Object

Object Veri kaynağını temsil eden bir.

dataMember
String

Bağlanacak özellik veya liste.

formattingEnabled
Boolean

true görüntülenen verileri biçimlendirmek için; aksi takdirde , false.

updateMode
DataSourceUpdateMode

Değerlerden DataSourceUpdateMode biri.

nullValue
Object

Veri kaynağı bu değere sahip olduğunda, ilişkili özellik olarak DBNullayarlanır.

formatString
String

Bir değerin nasıl görüntüleneceğini gösteren bir veya daha fazla biçim belirtici karakteri.

formatInfo
IFormatProvider

Varsayılan biçimlendirme davranışını geçersiz kılmak için uygulaması IFormatProvider .

Döndürülenler

Yeni oluşturulan Binding.

Özel durumlar

tarafından propertyName verilen özellik denetimde yok veya salt okunur.

-veya-

Belirtilen veri üyesi veri kaynağında yok.

-veya-

Belirtilen veri kaynağı, veri üyesi veya denetim özelliği koleksiyondaki başka bir bağlamayla ilişkilendirilir.

Açıklamalar

yöntemini çağırmak Add olayı tetikler CollectionChanged .

Şunlara uygulanır