Como: Vincular dados ao controle DataGridView do Windows Forms
O DataGridView controle oferece suporte ao modelo de vinculação de dados padrão do Windows Forms, para que possa se vincular a uma variedade de fontes de dados. Normalmente, você se associa a um BindingSource que gerencia a interação com a fonte de dados. O BindingSource pode ser qualquer fonte de dados do Windows Forms, o que oferece grande flexibilidade ao escolher ou modificar o local dos dados. Para obter mais informações sobre fontes de dados que o DataGridView controle suporta, consulte a Visão geral do controle DataGridView.
Visual Studio tem amplo suporte para vinculação de dados para o DataGridView controle. Para obter mais informações, consulte Como vincular dados ao controle DataGridView do Windows Forms usando o Designer.
Para conectar um controle DataGridView aos dados:
Implemente um método para manipular os detalhes da recuperação dos dados. O exemplo de código a seguir implementa um método que inicializa um , e o usa para preencher um
GetDataSqlDataAdapterDataTablearquivo . Em seguida, liga o DataTableBindingSourceao .No manipulador de Load eventos do formulário, vincule BindingSourceo controle ao , e chame o DataGridView
GetDatamétodo para recuperar os dados.
Exemplo
Este exemplo de código completo recupera dados de um banco de dados para preencher um controle DataGridView em um formulário do Windows. O formulário também tem botões para recarregar dados e enviar alterações ao banco de dados.
Este exemplo requer:
Acesso a um banco de dados de exemplo do Northwind SQL Server. Para obter mais informações sobre como instalar o banco de dados de exemplo Northwind, consulte Obter os bancos de dados de exemplo para exemplos de código ADO.NET.
Referências aos assemblies System, System.Windows.Forms, System.Data e System.Xml.
Para criar e executar este exemplo, cole o código no arquivo de código Form1 em um novo projeto do Windows Forms. Para obter informações sobre como criar a partir da linha de comando C# ou Visual Basic, consulte Compilação de linha de comando com csc.exe ou Compilar a partir da linha de comando.
Preencha a connectionString variável no exemplo com os valores para sua conexão de banco de dados de exemplo do SQL Server Northwind. A Autenticação do Windows, também chamada de segurança integrada, é uma maneira mais segura de se conectar ao banco de dados do que armazenar uma senha na cadeia de conexão. Para obter mais informações sobre segurança de conexão, consulte Proteger informações de conexão.
using System;
using System.Data;
using System.Data.SqlClient;
using System.Globalization;
using System.Windows.Forms;
namespace WindowsFormsApp
{
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
}
}
}
public class Form1 : 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();
[STAThread()]
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 EventHandler(ReloadButton_Click);
submitButton.Click += new EventHandler(SubmitButton_Click);
FlowLayoutPanel panel = new FlowLayoutPanel
{
Dock = DockStyle.Top,
AutoSize = true
};
panel.Controls.AddRange(new Control[] { reloadButton, submitButton });
Controls.AddRange(new Control[] { dataGridView1, panel });
Load += new EventHandler(Form1_Load);
Text = "DataGridView data binding and updating demo";
}
private void GetData(string selectCommand)
{
try
{
// Specify a connection string.
// Replace <SQL Server> with the SQL Server for your Northwind sample database.
// Replace "Integrated Security=True" with user login information if necessary.
String connectionString =
"Data Source=<SQL Server>;Initial Catalog=Northwind;" +
"Integrated Security=True";
// 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.
SqlCommandBuilder commandBuilder = new SqlCommandBuilder(dataAdapter);
// Populate a new data table and bind it to the BindingSource.
DataTable table = new DataTable
{
Locale = 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 Form1_Load(object sender, 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, EventArgs e)
{
// Reload the data from the database.
GetData(dataAdapter.SelectCommand.CommandText);
}
private void SubmitButton_Click(object sender, EventArgs e)
{
// Update the database with changes.
dataAdapter.Update((DataTable)bindingSource1.DataSource);
}
}
Imports System.Data.SqlClient
Imports System.Windows.Forms
Public Class Form1
Inherits 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()
Public Shared Sub Main()
Application.Run(New Form1())
End Sub
' Initialize the form.
Public Sub New()
dataGridView1.Dock = DockStyle.Fill
ReloadButton.Text = "Reload"
SubmitButton.Text = "Submit"
Dim panel As New FlowLayoutPanel With {
.Dock = DockStyle.Top,
.AutoSize = True
}
panel.Controls.AddRange(New Control() {ReloadButton, SubmitButton})
Controls.AddRange(New Control() {dataGridView1, panel})
Text = "DataGridView data binding and updating demo"
End Sub
Private Sub GetData(ByVal selectCommand As String)
Try
' Specify a connection string.
' Replace <SQL Server> with the SQL Server for your Northwind sample database.
' Replace "Integrated Security=True" with user login information if necessary.
Dim connectionString As String =
"Data Source=<SQL Server>;Initial Catalog=Northwind;" +
"Integrated Security=True;"
' 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.
Dim commandBuilder As New SqlCommandBuilder(dataAdapter)
' Populate a new data table and bind it to the BindingSource.
Dim table As New DataTable With {
.Locale = Globalization.CultureInfo.InvariantCulture
}
dataAdapter.Fill(table)
bindingSource1.DataSource = table
' Resize the DataGridView columns to fit the newly loaded content.
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 Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) _
Handles Me.Load
' Bind the DataGridView to the BindingSource
' and load the data from the database.
dataGridView1.DataSource = bindingSource1
GetData("select * from Customers")
End Sub
Private Sub ReloadButton_Click(ByVal sender As Object, ByVal e As EventArgs) _
Handles ReloadButton.Click
' Reload the data from the database.
GetData(dataAdapter.SelectCommand.CommandText)
End Sub
Private Sub SubmitButton_Click(ByVal sender As Object, ByVal e As EventArgs) _
Handles SubmitButton.Click
' Update the database with changes.
dataAdapter.Update(CType(bindingSource1.DataSource, DataTable))
End Sub
End Class
Confira também
.NET Desktop feedback
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de