DataGrid.SetDataBinding(Object, String) Methode

Definition

Legt die DataSource-Eigenschaft und die DataMember-Eigenschaft zur Laufzeit fest.Sets the DataSource and DataMember properties at run time.

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.The data source for the DataGrid control.

dataMember
String

Die DataMember-Zeichenfolge, die die Tabelle, an die die Bindung erfolgen soll, in dem durch die DataSource-Eigenschaft zurückgegebenen Objekt angibt.The DataMember string that specifies the table to bind to within the object returned by the DataSource property.

Ausnahmen

Mindestens ein Argument ist ungültig.One or more of the arguments are invalid.

Das dataSource-Argument lautet null.The dataSource argument is null.

Beispiele

Im folgenden Codebeispiel wird die DataSource und DataMember auf eine DataSet, und ein DataTable in der DataSetbzw.The following code example sets the DataSource and DataMember to a DataSet, and a DataTable in the DataSet, respectively.

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

Zum Zurücksetzen der DataSource-Eigenschaft müssen Sie die SetDataBinding-Methode zur Laufzeit verwenden.You must use the SetDataBinding method at run time to reset the DataSource property.

Weitere Informationen zum Festlegen einer gültigen Datenquelle finden Sie in der DataSource-Eigenschaft.See the DataSource property for more details about setting a valid data source.

Sie können ein Raster erstellen, das es Benutzern ermöglicht, Daten zu bearbeiten, aber verhindert, dass Sie neue Zeilen hinzufügen, indem Sie eine DataView als Datenquelle verwenden und die AllowNew-Eigenschaft auf falsefestlegen.You can create a grid that enables users to edit data but prevents them from adding new rows by using a DataView as the data source and setting the AllowNew property to false. Wenn die DataSource ein DataView oder DataTableist, legen Sie die DataMember auf eine leere Zeichenfolge ("") fest.When the DataSource is a DataView or DataTable, set the DataMember to an empty string ("").

Gilt für:

Siehe auch