Практическое руководство. Привязка данных к элементу управления DataGridView в Windows Forms
Элемент управления DataGridView поддерживает стандартную модель привязки данных Windows Forms, допускающую привязку к разнообразным источникам данных. Однако в большинстве случаев, привязка будет осуществляться к компоненту BindingSource, который будет управлять деталями взаимодействия с источником данных. Компонент BindingSource может представлять любой источник данных Windows Forms и обеспечивает значительную гибкость при выборе или изменении местоположения данных. Дополнительные сведения об источниках данных, поддерживаемых элементом управления DataGridView см. в разделе Общие сведения об элементе управления DataGridView (Windows Forms).
Расширенная поддержка Visual Studio для этой задачи. Дополнительные сведения см. в следующем разделе. Практическое руководство. Привязка данных к элементу управления DataGridView в форме Windows Forms с помощью конструктора и Практическое руководство. Привязка данных к элементу управления DataGridView в форме Windows Forms с помощью конструктора.
Процедура
Подключение элемента управления DataGridView к данным
Реализуйте метод для обработки подробных сведений получения данных из базы данных. В следующем примере кода реализован метод GetData, инициализирующий компонент SqlDataAdapter и использующий его для заполнения DataTable. DataTable затем привязывается к компоненту BindingSource. Переменной connectionString следует присвоить значение, подходящее для базы данных. Потребуется доступ к серверу с примером базы данных SQL Server под именем "Northwind".
Private Sub GetData(ByVal selectCommand As String) Try ' Specify a connection string. Replace the given value with a ' valid connection string for a Northwind SQL Server sample ' database accessible to your system. Dim connectionString As String = _ "Integrated Security=SSPI;Persist Security Info=False;" + _ "Initial Catalog=Northwind;Data Source=localhost" ' Create a new data adapter based on the specified query. Me.dataAdapter = New SqlDataAdapter(selectCommand, connectionString) ' Create a command builder to generate SQL update, insert, and ' delete commands based on selectCommand. These are used to ' update the database. Dim commandBuilder As New SqlCommandBuilder(Me.dataAdapter) ' Populate a new data table and bind it to the BindingSource. Dim table As New DataTable() table.Locale = System.Globalization.CultureInfo.InvariantCulture Me.dataAdapter.Fill(table) Me.bindingSource1.DataSource = table ' Resize the DataGridView columns to fit the newly loaded content. Me.dataGridView1.AutoResizeColumns( _ DataGridViewAutoSizeColumnsMode.AllCellsExceptHeader) Catch ex As SqlException MessageBox.Show("To run this example, replace the value of the " + _ "connectionString variable with a connection string that is " + _ "valid for your system.") End Try End Sub
private void GetData(string selectCommand) { try { // Specify a connection string. Replace the given value with a // valid connection string for a Northwind SQL Server sample // database accessible to your system. String connectionString = "Integrated Security=SSPI;Persist Security Info=False;" + "Initial Catalog=Northwind;Data Source=localhost"; // Create a new data adapter based on the specified query. dataAdapter = new SqlDataAdapter(selectCommand, connectionString); // Create a command builder to generate SQL update, insert, and // delete commands based on selectCommand. These are used to // update the database. SqlCommandBuilder commandBuilder = new SqlCommandBuilder(dataAdapter); // Populate a new data table and bind it to the BindingSource. DataTable table = new DataTable(); table.Locale = System.Globalization.CultureInfo.InvariantCulture; dataAdapter.Fill(table); bindingSource1.DataSource = table; // Resize the DataGridView columns to fit the newly loaded content. dataGridView1.AutoResizeColumns( DataGridViewAutoSizeColumnsMode.AllCellsExceptHeader); } catch (SqlException) { MessageBox.Show("To run this example, replace the value of the " + "connectionString variable with a connection string that is " + "valid for your system."); } }
private: void GetData(String^ selectCommand) { try { // Specify a connection string. Replace the given value with a // valid connection string for a Northwind SQL Server sample // database accessible to your system. String^ connectionString = "Integrated Security=SSPI;Persist Security Info=False;" + "Initial Catalog=Northwind;Data Source=localhost"; // Create a new data adapter based on the specified query. dataAdapter = gcnew SqlDataAdapter(selectCommand, connectionString); // Create a command builder to generate SQL update, insert, and // delete commands based on selectCommand. These are used to // update the database. gcnew SqlCommandBuilder(dataAdapter); // Populate a new data table and bind it to the BindingSource. DataTable^ table = gcnew DataTable(); dataAdapter->Fill(table); bindingSource1->DataSource = table; // Resize the DataGridView columns to fit the newly loaded content. dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCellsExceptHeader); } catch (SqlException^) { MessageBox::Show("To run this example, replace the value of the " + "connectionString variable with a connection string that is " + "valid for your system."); } }
В обработчике событий Load формы привяжите элемент управления DataGridView к компоненту BindingSource и вызовите метод GetData для извлечения данных из базы данных.
Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) _ Handles Me.Load ' Bind the DataGridView to the BindingSource ' and load the data from the database. Me.dataGridView1.DataSource = Me.bindingSource1 GetData("select * from Customers") End Sub
private void Form1_Load(object sender, System.EventArgs e) { // Bind the DataGridView to the BindingSource // and load the data from the database. dataGridView1.DataSource = bindingSource1; GetData("select * from Customers"); }
void Form1_Load(Object^ /*sender*/, System::EventArgs^ /*e*/) { // Bind the DataGridView to the BindingSource // and load the data from the database. dataGridView1->DataSource = bindingSource1; GetData("select * from Customers"); }
Пример
В следующем примере полного кода содержатся кнопки для перезагрузки данных из базы данных и отправки изменений в базу данных.
Imports System
Imports System.Data
Imports System.Data.SqlClient
Imports System.Windows.Forms
Public Class Form1
Inherits System.Windows.Forms.Form
Private dataGridView1 As New DataGridView()
Private bindingSource1 As New BindingSource()
Private dataAdapter As New SqlDataAdapter()
Private WithEvents reloadButton As New Button()
Private WithEvents submitButton As New Button()
<STAThreadAttribute()> _
Public Shared Sub Main()
Application.Run(New Form1())
End Sub
' Initialize the form.
Public Sub New()
Me.dataGridView1.Dock = DockStyle.Fill
Me.reloadButton.Text = "reload"
Me.submitButton.Text = "submit"
Dim panel As New FlowLayoutPanel()
panel.Dock = DockStyle.Top
panel.AutoSize = True
panel.Controls.AddRange(New Control() {Me.reloadButton, Me.submitButton})
Me.Controls.AddRange(New Control() {Me.dataGridView1, panel})
Me.Text = "DataGridView databinding and updating demo"
End Sub
Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Me.Load
' Bind the DataGridView to the BindingSource
' and load the data from the database.
Me.dataGridView1.DataSource = Me.bindingSource1
GetData("select * from Customers")
End Sub
Private Sub reloadButton_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles reloadButton.Click
' Reload the data from the database.
GetData(Me.dataAdapter.SelectCommand.CommandText)
End Sub
Private Sub submitButton_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles submitButton.Click
' Update the database with the user's changes.
Me.dataAdapter.Update(CType(Me.bindingSource1.DataSource, DataTable))
End Sub
Private Sub GetData(ByVal selectCommand As String)
Try
' Specify a connection string. Replace the given value with a
' valid connection string for a Northwind SQL Server sample
' database accessible to your system.
Dim connectionString As String = _
"Integrated Security=SSPI;Persist Security Info=False;" + _
"Initial Catalog=Northwind;Data Source=localhost"
' Create a new data adapter based on the specified query.
Me.dataAdapter = New SqlDataAdapter(selectCommand, connectionString)
' Create a command builder to generate SQL update, insert, and
' delete commands based on selectCommand. These are used to
' update the database.
Dim commandBuilder As New SqlCommandBuilder(Me.dataAdapter)
' Populate a new data table and bind it to the BindingSource.
Dim table As New DataTable()
table.Locale = System.Globalization.CultureInfo.InvariantCulture
Me.dataAdapter.Fill(table)
Me.bindingSource1.DataSource = table
' Resize the DataGridView columns to fit the newly loaded content.
Me.dataGridView1.AutoResizeColumns( _
DataGridViewAutoSizeColumnsMode.AllCellsExceptHeader)
Catch ex As SqlException
MessageBox.Show("To run this example, replace the value of the " + _
"connectionString variable with a connection string that is " + _
"valid for your system.")
End Try
End Sub
End Class
using System;
using System.Data;
using System.Data.SqlClient;
using System.Windows.Forms;
public class Form1 : System.Windows.Forms.Form
{
private DataGridView dataGridView1 = new DataGridView();
private BindingSource bindingSource1 = new BindingSource();
private SqlDataAdapter dataAdapter = new SqlDataAdapter();
private Button reloadButton = new Button();
private Button submitButton = new Button();
[STAThreadAttribute()]
public static void Main()
{
Application.Run(new Form1());
}
// Initialize the form.
public Form1()
{
dataGridView1.Dock = DockStyle.Fill;
reloadButton.Text = "reload";
submitButton.Text = "submit";
reloadButton.Click += new System.EventHandler(reloadButton_Click);
submitButton.Click += new System.EventHandler(submitButton_Click);
FlowLayoutPanel panel = new FlowLayoutPanel();
panel.Dock = DockStyle.Top;
panel.AutoSize = true;
panel.Controls.AddRange(new Control[] { reloadButton, submitButton });
this.Controls.AddRange(new Control[] { dataGridView1, panel });
this.Load += new System.EventHandler(Form1_Load);
this.Text = "DataGridView databinding and updating demo";
}
private void Form1_Load(object sender, System.EventArgs e)
{
// Bind the DataGridView to the BindingSource
// and load the data from the database.
dataGridView1.DataSource = bindingSource1;
GetData("select * from Customers");
}
private void reloadButton_Click(object sender, System.EventArgs e)
{
// Reload the data from the database.
GetData(dataAdapter.SelectCommand.CommandText);
}
private void submitButton_Click(object sender, System.EventArgs e)
{
// Update the database with the user's changes.
dataAdapter.Update((DataTable)bindingSource1.DataSource);
}
private void GetData(string selectCommand)
{
try
{
// Specify a connection string. Replace the given value with a
// valid connection string for a Northwind SQL Server sample
// database accessible to your system.
String connectionString =
"Integrated Security=SSPI;Persist Security Info=False;" +
"Initial Catalog=Northwind;Data Source=localhost";
// Create a new data adapter based on the specified query.
dataAdapter = new SqlDataAdapter(selectCommand, connectionString);
// Create a command builder to generate SQL update, insert, and
// delete commands based on selectCommand. These are used to
// update the database.
SqlCommandBuilder commandBuilder = new SqlCommandBuilder(dataAdapter);
// Populate a new data table and bind it to the BindingSource.
DataTable table = new DataTable();
table.Locale = System.Globalization.CultureInfo.InvariantCulture;
dataAdapter.Fill(table);
bindingSource1.DataSource = table;
// Resize the DataGridView columns to fit the newly loaded content.
dataGridView1.AutoResizeColumns(
DataGridViewAutoSizeColumnsMode.AllCellsExceptHeader);
}
catch (SqlException)
{
MessageBox.Show("To run this example, replace the value of the " +
"connectionString variable with a connection string that is " +
"valid for your system.");
}
}
}
#using <System.Data.dll>
#using <System.Transactions.dll>
#using <System.EnterpriseServices.dll>
#using <System.Xml.dll>
#using <System.Drawing.dll>
#using <System.dll>
#using <System.Windows.Forms.dll>
using namespace System;
using namespace System::Data;
using namespace System::Data::SqlClient;
using namespace System::Windows::Forms;
public ref class Form1 : public System::Windows::Forms::Form
{
private:
DataGridView^ dataGridView1;
private:
BindingSource^ bindingSource1;
private:
SqlDataAdapter^ dataAdapter;
private:
Button^ reloadButton;
private:
Button^ submitButton;
public:
static void Main()
{
Application::Run(gcnew Form1());
}
// Initialize the form.
public:
Form1()
{
dataGridView1 = gcnew DataGridView();
bindingSource1 = gcnew BindingSource();
dataAdapter = gcnew SqlDataAdapter();
reloadButton = gcnew Button();
submitButton = gcnew Button();
dataGridView1->Dock = DockStyle::Fill;
reloadButton->Text = "reload";
submitButton->Text = "submit";
reloadButton->Click += gcnew System::EventHandler(this,&Form1::reloadButton_Click);
submitButton->Click += gcnew System::EventHandler(this,&Form1::submitButton_Click);
FlowLayoutPanel^ panel = gcnew FlowLayoutPanel();
panel->Dock = DockStyle::Top;
panel->AutoSize = true;
panel->Controls->AddRange(gcnew array<Control^> { reloadButton, submitButton });
this->Controls->AddRange(gcnew array<Control^> { dataGridView1, panel });
this->Load += gcnew System::EventHandler(this,&Form1::Form1_Load);
}
void Form1_Load(Object^ /*sender*/, System::EventArgs^ /*e*/)
{
// Bind the DataGridView to the BindingSource
// and load the data from the database.
dataGridView1->DataSource = bindingSource1;
GetData("select * from Customers");
}
void reloadButton_Click(Object^ /*sender*/, System::EventArgs^ /*e*/)
{
// Reload the data from the database.
GetData(dataAdapter->SelectCommand->CommandText);
}
void submitButton_Click(Object^ /*sender*/, System::EventArgs^ /*e*/)
{
// Update the database with the user's changes.
dataAdapter->Update((DataTable^)bindingSource1->DataSource);
}
private:
void GetData(String^ selectCommand)
{
try
{
// Specify a connection string. Replace the given value with a
// valid connection string for a Northwind SQL Server sample
// database accessible to your system.
String^ connectionString =
"Integrated Security=SSPI;Persist Security Info=False;" +
"Initial Catalog=Northwind;Data Source=localhost";
// Create a new data adapter based on the specified query.
dataAdapter = gcnew SqlDataAdapter(selectCommand, connectionString);
// Create a command builder to generate SQL update, insert, and
// delete commands based on selectCommand. These are used to
// update the database.
gcnew SqlCommandBuilder(dataAdapter);
// Populate a new data table and bind it to the BindingSource.
DataTable^ table = gcnew DataTable();
dataAdapter->Fill(table);
bindingSource1->DataSource = table;
// Resize the DataGridView columns to fit the newly loaded content.
dataGridView1->AutoResizeColumns(
DataGridViewAutoSizeColumnsMode::AllCellsExceptHeader);
}
catch (SqlException^)
{
MessageBox::Show("To run this example, replace the value of the " +
"connectionString variable with a connection string that is " +
"valid for your system.");
}
}
};
Компиляция кода
Для этого примера требуются перечисленные ниже компоненты.
- Ссылки на сборки System, System.Windows.Forms, System.Data, и System.XML.
Дополнительные сведения о построении этого примера из командной строки для Visual Basic или Visual C# см. в разделе Построение из командной строки (Visual Basic) или Построение из командной строки с помощью csc.exe. Можно также построить этот пример в Visual Studio путем вставки кода в новый проект. Дополнительные сведения см. в следующем разделе. Практическое руководство. Компиляция и выполнение откомпилированного примера кода формы Windows Forms с помощью Visual Studio и Практическое руководство. Компиляция и выполнение откомпилированного примера кода формы Windows Forms с помощью Visual Studio и Практическое руководство. Компиляция и выполнение откомпилированного примера кода формы Windows Forms с помощью Visual Studio.
Безопасность
Хранение в строке подключения конфиденциальных сведений, таких как пароль, может привести к снижению уровня защиты приложения. Использование проверки подлинности Windows (также называемой встроенными средствами безопасности) – более безопасный способ управления доступом к базе данных. Дополнительные сведения см. в разделе Защита сведений о соединении (ADO.NET).
См. также
Ссылки
Основные понятия
Защита сведений о соединении (ADO.NET)
Другие ресурсы
Отображение данных с помощью элемента управления DataGridView в Windows Forms