Instrukcje: wiązanie danych z kontrolką DataGridView formularzy systemu Windows

  • Artykuł

Kontrolka DataGridView obsługuje standardowy model powiązania danych formularzy systemu Windows, dzięki czemu może być powiązany z różnymi źródłami danych. Zazwyczaj wiąże się to z elementem BindingSource , który zarządza interakcją ze źródłem danych. Może BindingSource to być dowolne źródło danych formularzy systemu Windows, które zapewnia dużą elastyczność podczas wybierania lub modyfikowania lokalizacji danych. Aby uzyskać więcej informacji na temat źródeł danych, które obsługuje kontrolkaDataGridView, zobacz Omówienie kontrolki DataGridView.

Program Visual Studio ma rozbudowaną obsługę powiązania danych z kontrolką DataGridView. Aby uzyskać więcej informacji, zobacz How to: Bind data to the Windows Forms DataGridView control using the Projektant (Instrukcje: wiązanie danych z kontrolką DataGridView formularzy systemu Windows przy użyciu Projektant).

Aby połączyć kontrolkę DataGridView z danymi:

  1. Zaimplementuj metodę do obsługi szczegółów pobierania danych. Poniższy przykład kodu implementuje metodę, która inicjuje GetDataSqlDataAdapterelement , i używa go do wypełnienia elementu DataTable. Następnie wiąże element z DataTable elementem BindingSource.

  2. W procedurze obsługi zdarzeń formularza Load powiąż kontrolkę DataGridView z elementem BindingSourcei wywołaj GetData metodę w celu pobrania danych.

Przykład

Ten kompletny przykład kodu pobiera dane z bazy danych w celu wypełnienia kontrolki DataGridView w formularzu systemu Windows. Formularz zawiera również przyciski ponownego ładowania danych i przesyłania zmian do bazy danych.

Ten przykład wymaga:

  • Dostęp do przykładowej bazy danych Northwind SQL Server. Aby uzyskać więcej informacji na temat instalowania przykładowej bazy danych Northwind, zobacz Pobieranie przykładowych baz danych dla przykładów kodu ADO.NET.

  • Odwołania do zestawów System, System.Windows.Forms, System.Data i System.Xml.

Aby skompilować i uruchomić ten przykład, wklej kod do pliku kodu Form1 w nowym projekcie Windows Forms. Aby uzyskać informacje na temat kompilowania z poziomu wiersza polecenia języka C# lub Visual Basic, zobacz Kompilowanie wiersza polecenia za pomocą pliku csc.exe lub Build z wiersza polecenia.

Wypełnij zmienną connectionString w przykładzie wartościami dla przykładowego połączenia z bazą danych Northwind SQL Server. Uwierzytelnianie systemu Windows, nazywane również zabezpieczeniami zintegrowanymi, to bezpieczniejszy sposób nawiązywania połączenia z bazą danych niż przechowywanie hasła w parametry połączenia. Aby uzyskać więcej informacji na temat zabezpieczeń połączeń, zobacz Ochrona informacji o połączeniu.

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

Zobacz też