DataGrid.DataSource Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

DataGrid.cs

Kılavuzun verileri görüntülendiği veri kaynağını alır veya ayarlar.

public:
 property System::Object ^ DataSource { System::Object ^ get(); void set(System::Object ^ value); };

public object DataSource { get; set; }

member this.DataSource : obj with get, set

Public Property DataSource As Object

Özellik Değeri

Object

Veri kaynağı olarak işlev gösteren bir nesne.

Örnekler

Aşağıdaki kod örneğinde, hem hem de DataView öğesine bağlamak System.Windows.Forms.DataGrid için ve gerektiğinde DataMemberdeğerinin nasıl ayarlanacağı DataSourcegösterilmektedirDataSet. Örnekte ayrıca veri kaynaklarının içinden nasıl döndürüleceği de gösterilmektedir System.Windows.Forms.DataGrid.

private:
   void BindToDataView( DataGrid^ myGrid )
   {
      // Create a DataView using the DataTable.
      DataTable^ myTable = gcnew DataTable( "Suppliers" );
      // Insert code to create and populate columns.
      DataView^ myDataView = gcnew DataView( myTable );
      myGrid->DataSource = myDataView;
   }

   void BindToDataSet( DataGrid^ myGrid )
   {
      // Create a DataSet.
      DataSet^ myDataSet = gcnew DataSet( "myDataSet" );
      // Insert code to populate DataSet with several tables.
      myGrid->DataSource = myDataSet;
      // Use the DataMember property to specify the DataTable.
      myGrid->DataMember = "Suppliers";
   }

   DataView^ GetDataViewFromDataSource()
   {
      // Create a DataTable variable, and set it to the DataSource.
      DataView^ myDataView;
      myDataView = (DataView^)(dataGrid1->DataSource);
      return myDataView;
   }

   DataSet^ GetDataSetFromDataSource()
   {
      // Create a DataSet variable, and set it to the DataSource.
      DataSet^ myDataSet;
      myDataSet = (DataSet^)(dataGrid1->DataSource);
      return myDataSet;
   }

private void BindToDataView(DataGrid myGrid){
    // Create a DataView using the DataTable.
    DataTable myTable = new DataTable("Suppliers");
    // Insert code to create and populate columns.
    DataView myDataView = new DataView(myTable);
    myGrid.DataSource = myDataView;
 }
 private void BindToDataSet(DataGrid myGrid){
    // Create a DataSet.
    DataSet myDataSet = new DataSet("myDataSet");
    // Insert code to populate DataSet with several tables.
    myGrid.DataSource = myDataSet;
    // Use the DataMember property to specify the DataTable.
    myGrid.DataMember = "Suppliers";
 }
 private DataView GetDataViewFromDataSource(){
    // Create a DataTable variable, and set it to the DataSource.
    DataView myDataView;
    myDataView = (DataView) dataGrid1.DataSource;
    return myDataView;
 }
 private DataSet GetDataSetFromDataSource(){
    // Create a DataSet variable, and set it to the DataSource.
    DataSet myDataSet;
    myDataSet = (DataSet) dataGrid1.DataSource;
    return myDataSet;
 }

Private Sub BindToDataView(myGrid As DataGrid)
    ' Create a DataView using the DataTable.
    Dim myTable As New DataTable("Suppliers")
    ' Insert code to create and populate columns.
    Dim myDatatView As New DataView(myTable)
    myGrid.DataSource = myDatatView
End Sub

Private Sub BindToDataSet(myGrid As DataGrid)
    ' Create a DataSet.
    Dim myDataSet As New DataSet("myDataSet")
    ' Insert code to populate DataSet with several tables.
    myGrid.DataSource = myDataSet
    ' Use the DataMember property to specify the DataTable.
    myGrid.DataMember = "Suppliers"
End Sub

Private Function GetDataViewFromDataSource() As DataView
    ' Create a DataTable variable, and set it to the DataSource.
    Dim myDatatView As DataView
    myDatatView = CType(dataGrid1.DataSource, DataView)
    Return myDatatView
End Function 'GetDataViewFromDataSource

Private Function GetDataSetFromDataSource() As DataSet
    ' Create a DataSet variable, and set it to the DataSource.
    Dim myDataSet As DataSet
    myDataSet = CType(dataGrid1.DataSource, DataSet)
    Return myDataSet
End Function 'GetDataSetFromDataSource

Açıklamalar

Çalışma zamanında ve DataMember özelliklerini ayarlamak DataSource için yöntemini kullanınSetDataBinding.

Aşağıdaki veri kaynakları geçerlidir:

• Bir DataTable

• Bir DataView

• Bir DataSet

• Bir DataViewManager

• Arabirimi uygulayan IListSource herhangi bir bileşen

• Arabirimi uygulayan IList herhangi bir bileşen

Binding Veri kaynakları hakkında daha fazla bilgi için sınıfa genel bakış bölümüne bakın.

DataSource Başvuru birden fazla tablo içeriyorsa, özelliğini bağlanacak tabloyu belirten bir dize ayarlamanız DataMember gerekir. Örneğin , DataSource ve OrderDetailsadlı OrdersCustomersüç tablo içeren bir DataSet veya DataViewManager ise, bağlanılacak tabloyu belirtmeniz gerekir.

DataSource öğesini arabirimini uygulamayan bir nesneye veya bir IListSource nesnesine IList ayarlamak, kılavuzun özel durum oluşturmasına neden olur.

Kullanıcıların verileri düzenlemesine olanak tanıyan ancak veri kaynağı olarak bir kullanarak ve özelliğini falseolarak ayarlayarak AddNew() yeni satır eklemelerini engelleyen bir DataView kılavuz oluşturabilirsiniz.

öğesini kesin olarak belirlenmiş bir nesne dizisine bağlamak DataGrid için nesne türünün ortak özellikler içermesi gerekir. Diziyi görüntüleyen bir DataGridTableStyle oluşturmak için, özelliğini typename nesne türünün adıyla değiştirileceği yere typename ayarlayınDataGridTableStyle.MappingName. Ayrıca özelliğin büyük/küçük harfe MappingName duyarlı olduğunu unutmayın; tür adı tam olarak eşleşmelidir. Bir örnek için özelliğine MappingName bakın.

öğesini bir ArrayListöğesine de bağlayabilirsinizDataGrid. özelliğinin ArrayList bir özelliği, birden çok türde nesne içerebileceğidir, ancak DataGrid yalnızca listedeki tüm öğeler ilk öğeyle aynı türde olduğunda böyle bir listeye bağlanabilir. Bu, tüm nesnelerin aynı türde olması veya listedeki ilk öğeyle aynı sınıftan devralması gerektiği anlamına gelir. Örneğin, listedeki ilk öğe bir Controlise, ikinci öğe bir TextBox (öğesinden Controldevralınır) olabilir. Öte yandan, ilk öğe bir TextBoxise, ikinci nesne bir Contrololamaz. Ayrıca, ArrayList bağlı olduğunda içinde öğeler olmalıdır. Boş bir kılavuz boş ArrayList bir kılavuza neden olur. Ayrıca içindeki nesneler ArrayList ortak özellikler içermelidir. bir ArrayListöğesine bağlarken öğesinin MappingName değerini DataGridTableStyle "ArrayList" (tür adı) olarak ayarlayın.

Ayrıca bkz.

• DataMember
• DataSet
• DataViewManager
• DataView