DataGrid.DataSource Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kılavuzun verilerini 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ği, hem hem de DataViewDataSetöğesine bağlamak System.Windows.Forms.DataGrid için , ve gerektiğinde DataMemberdeğerinin nasıl ayarlandığını DataSourcegösterir. Ö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:

• DataTable

• DataView

• DataSet

• DataViewManager

• Arabirimi uygulayan IListSource tüm bileşenler

• Arabirimi uygulayan IList tüm bileşenler

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 veya arabirimini IListSource uygulamayan bir nesneye 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ırlar 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ştirildiği konumuna 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çermesi, ancak DataGrid listedeki tüm öğelerin ilk öğeyle aynı türde olması halinde bu tür bir listeye bağlanabilmesidir. 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 olabilir (öğesinden Controldevralınır). Öte yandan, ilk öğe bir TextBoxise, ikinci nesne bir Contrololamaz. Ayrıca, ArrayList bağlı olduğunda içinde öğeler olmalıdır. Boş ArrayList bir kılavuz boş bir kılavuza neden olur. Ayrıca içindeki nesneler ArrayList ortak özellikler içermelidir. bir ArrayListöğesine bağlanırken öğesinin değerini MappingNameDataGridTableStyle "ArrayList" (tür adı) olarak ayarlayın.

Ayrıca bkz.

• DataMember
• DataSet
• DataViewManager
• DataView