DataGrid.SetDataBinding(Object, String) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Legt die DataSource-Eigenschaft und die DataMember-Eigenschaft zur Laufzeit fest.

public:
 void SetDataBinding(System::Object ^ dataSource, System::String ^ dataMember);

public void SetDataBinding (object dataSource, string dataMember);

member this.SetDataBinding : obj * string -> unit

Public Sub SetDataBinding (dataSource As Object, dataMember As String)

Parameter

dataSource: Object

Die Datenquelle für das DataGrid-Steuerelement.

dataMember: String

Die DataMember-Zeichenfolge, die die Tabelle, an die die Bindung erfolgen soll, in dem durch die DataSource-Eigenschaft zurückgegebenen Objekt angibt.

Ausnahmen

ArgumentException

Mindestens ein Argument ist ungültig.

ArgumentNullException

Das dataSource-Argument lautet null.

Beispiele

Im folgenden Codebeispiel wird die DataSource und DataMember auf eine DataSet, und ein DataTable in der DataSetbzw.

private:
   void BindControls()
   {
      // Creates a DataSet named SuppliersProducts.
      DataSet^ SuppliersProducts = gcnew DataSet( "SuppliersProducts" );
      // Adds two DataTable objects, Suppliers and Products.
      SuppliersProducts->Tables->Add( gcnew DataTable( "Suppliers" ) );
      SuppliersProducts->Tables->Add( gcnew DataTable( "Products" ) );
      // Insert code to add DataColumn objects.
      // Insert code to fill tables with columns and data.
      // Binds the DataGrid to the DataSet, displaying the Suppliers table.
      dataGrid1->SetDataBinding( SuppliersProducts, "Suppliers" );
   }

private void BindControls(){
    // Creates a DataSet named SuppliersProducts.
    DataSet SuppliersProducts = new DataSet("SuppliersProducts");
    // Adds two DataTable objects, Suppliers and Products.
    SuppliersProducts.Tables.Add(new DataTable("Suppliers"));
    SuppliersProducts.Tables.Add(new DataTable("Products"));
    // Insert code to add DataColumn objects.
    // Insert code to fill tables with columns and data.
    // Binds the DataGrid to the DataSet, displaying the Suppliers table.
    dataGrid1.SetDataBinding(SuppliersProducts, "Suppliers");
 }

Private Sub BindControls()
    ' Create a DataSet named SuppliersProducts.
    Dim SuppliersProducts As New DataSet("SuppliersProducts")
    ' Adds two DataTable objects, Suppliers and Products.
    SuppliersProducts.Tables.Add(New DataTable("Suppliers"))
    SuppliersProducts.Tables.Add(New DataTable("Products"))
    ' Insert code to add DataColumn objects.
    ' Insert code to fill tables with columns and data.
    ' Binds the DataGrid to the DataSet, displaying the Suppliers table.
    dataGrid1.SetDataBinding(SuppliersProducts, "Suppliers")
End Sub

Hinweise

Sie müssen die Methode zur Laufzeit verwenden, um die SetDataBinding DataSource Eigenschaft zurückzusetzen.

Weitere Informationen zum Festlegen einer gültigen Datenquelle finden Sie in der DataSource Eigenschaft.

Sie können ein Raster erstellen, mit dem Benutzer Daten bearbeiten können, aber verhindert, dass sie neue Zeilen hinzufügen, indem Sie eine Datenquelle verwenden DataView und die AllowNew Eigenschaft auf falsefestlegen. Wenn es DataSource sich um eine DataView oder DataTable, legen Sie die DataMember Zeichenfolge auf eine leere Zeichenfolge ("") fest.

Gilt für

Freigeben über