Практическое руководство. Привязка элемента управления DataGrid в Windows Forms к источнику данных

Обновлен: Ноябрь 2007

Примечание.
Элемент управления DataGridView заменяет элемент управления DataGrid и расширяет его функциональные возможности; однако при необходимости элемент управления DataGrid можно сохранить для обратной совместимости и использования в будущем. Дополнительные сведения см. в разделе Различия элементов управления DataGridView и DataGrid в Windows Forms.

Элемент управления Windows Forms DataGrid разработан специально для отображения сведений из источника данных. Элемент управления можно привязать во время выполнения, вызвав метод SetDataBinding. Несмотря на то что данные можно открывать из различных источников, обычно в качестве источников используются наборы данных и представления данных.

Чтобы выполнить привязку данных для элемента управления DataGrid программными средствами

1. Напишите код для заполнения набора данных.

   Если источником данных является набор данных или представление данных, основанное на таблице DataSet, добавьте код в форму для заполнения набора данных.

   Текст программы зависит от расположения, из которого данные поступают в набор. Если набор данных заполняется непосредственно из базы данных, обычно вызывается метод Fill адаптера данных, как в приведенном ниже примере, который заполняет набор данных с именем DsCategories1.

   sqlDataAdapter1.Fill(DsCategories1)
   

   sqlDataAdapter1.Fill(DsCategories1);
   

   sqlDataAdapter1->Fill(dsCategories1);
   

   Если набор данных заполняется с помощью веб-службы XML, обычно в коде создается экземпляр службы, а затем вызывается один из ее методов для извлечения набора данных. Затем набор данных, полученный из веб-службы XML, объединяется с локальным набором данных. В следующем примере показано, как можно создать экземпляр веб-службы XML с именем CategoriesService, вызвать его метод GetCategories и объединить полученный в результате этого набор данных с локальным набором данных DsCategories1:

   Dim ws As New MyProject.localhost.CategoriesService()
   ws.Credentials = System.Net.CredentialCache.DefaultCredentials
   DsCategories1.Merge(ws.GetCategories())
   

   MyProject.localhost.CategoriesService ws = new MyProject.localhost.CategoriesService();
   ws.Credentials = System.Net.CredentialCache.DefaultCredentials;
   DsCategories1.Merge(ws.GetCategories());
   

   MyProject::localhost::CategoriesService^ ws = 
      new MyProject::localhost::CategoriesService();
   ws->Credentials = System::Net::CredentialCache::DefaultCredentials;
   dsCategories1->Merge(ws->GetCategories());
   

2. Вызовите метод SetDataBinding элемента управления DataGrid и передайте ему источник данных и член данных. Если не требуется явно передавать член данных, передайте пустую строку.

   Примечание.
   При привязке сетки впервые, можно задать свойства DataSource и DataMember элемента управления. Однако если значения этих свойств уже определены, изменять их нельзя. Таким образом, всегда рекомендуется пользоваться методом SetDataBinding.

   В следующем примере показано, как программными средствами выполнить привязку к таблице Customers в наборе данных DsCustomers1:

   DataGrid1.SetDataBinding(DsCustomers1, "Customers")
   

   DataGrid1.SetDataBinding(DsCustomers1, "Customers");
   

   dataGrid1->SetDataBinding(dsCustomers1, "Customers");
   

   Если таблица Customers единственная в наборе данных, сетку можно также привязать следующим способом:

   DataGrid1.SetDataBinding(DsCustomers1, "")
   

   DataGrid1.SetDataBinding(DsCustomers1, "");
   

   dataGrid1->SetDataBinding(dsCustomers1, "");
   

3. (Необязательно). Добавьте в сетку требуемые стили таблиц и столбцов. Если стили таблиц отсутствуют, таблица отобразится с минимальным форматированием, при этом все столбцы будут доступны для просмотра.

См. также

Задачи

Практическое руководство. Добавление таблиц и столбцов в элемент управления DataGrid в Windows Forms

Ссылки

Общие сведения об элементе управления DataGrid (Windows Forms)

Другие ресурсы

Элемент управления DataGrid (Windows Forms)

Связывание элементов управления Windows Forms с данными