使用 ADO.NET 建立簡單的資料應用程式

發行項
01/12/2024

注意

資料集和相關類別是 2000 年代初的舊版 .NET Framework 技術，可讓應用程式在應用程式與資料庫中斷連線時使用記憶體中的資料。它們特別適用於可讓使用者修改資料並將變更保存回資料庫的應用程式。雖然已證明資料集是非常成功的技術，但建議新的 .NET 應用程式使用 Entity Framework Core。 Entity Framework 提供更自然的方式，將表格式資料作為物件模型使用，而且具有更簡單的程式設計介面。

建立應用程式來管理資料庫中的資料時，您會執行基本工作，例如定義連接字串、插入資料及執行預存程序。遵循本主題，您可以探索如何使用 Visual C# 或 Visual Basic 和 ADO.NET，與簡單的 Windows Forms「資料表單」應用程式內的資料庫互動。所有 .NET 資料技術，包括資料集、LINQ to SQL 和 Entity Framework，最終都會執行與本文所示非常類似的步驟。

本文示範快速將資料從資料庫取出的簡單方式。如果您的應用程式需要以非一般的方式修改資料並更新資料庫，您應該考慮使用 Entity Framework，並使用資料繫結來自動同步使用者介面控制項以變更基礎資料。

重要

為了簡化程式碼，它不會包含已準備好投入生產環境的例外狀況處理。

注意

本教學課程的完整程式碼可以在 C# 和 Visual Basic 的 Visual Studio 文件 GitHub 存放庫中存取。

必要條件

若要建立應用程式，您需要：

已安裝 .NET 桌面開發和資料儲存和處理工作負載的 Visual Studio。若要安裝，請開啟 Visual Studio 安裝程式並選擇您要修改 Visual Studio 版本旁的 [修正] (或 [其他]>[修改])。
SQL Server Express LocalDB。如果您沒有 SQL Server Express LocalDB，您可以從 SQL Server 下載頁面來安裝它。

本主題假設您熟悉 Visual Studio IDE 的基本功能，且可以建立 Windows Forms 應用程式、將表單加入至該專案、將按鈕和其他控制項放置在這些表單上、設定這些控制項的屬性，以及編碼簡單事件。如果您不熟悉這些工作，建議您先完成使用 Visual Basic 在 Visual Studio 中建立 Windows Forms 應用程式教學課程，或在 Visual Studio 中使用 C# 建立 Windows Forms 應用程式教學課程，然後再開始本逐步解說。

設定範例資料庫

依照下列步驟建立範例資料庫：

在 Visual Studio 中，開啟 [伺服器總管] 視窗。
以滑鼠右鍵按一下 [資料連線]，然後選擇 [建立新的 SQL Server 資料庫]。
在 [伺服器名稱] 文字方塊中，輸入 (localdb)\mssqllocaldb。
在 [新增資料庫名稱] 文字方塊中，輸入銷售，然後選擇 [確定]。

空的銷售資料庫即會建立並新增至 [伺服器總管] 中的 [資料連線] 節點。
以滑鼠右鍵按一下 [銷售] 資料連線，然後選取 [新增查詢]。

查詢編輯器視窗會隨即開啟。
將銷售 Transact-SQL 指令碼複製到剪貼簿。
將 T-SQL 指令碼貼入查詢編輯器中，然後選擇 [執行] 按鈕。

查詢會在短時間內完成執行，並建立資料庫物件。資料庫包含兩個資料表：客戶和訂單。資料表一開始不包含任何資料，但是當您執行建立的應用程式時，您可以新增資料。資料庫也包含四個簡單的預存程序。

建立表單並加入控制項

使用 Windows Forms 應用程式 (.NET Framework) 範本建立 C# 或 Visual Basic 專案，然後將其命名為 SimpleDataApp。

Visual Studio 會建立專案和數個檔案，包括名為 Form1 的空白 Windows 表單。
將兩個 Windows 表單新增至專案，使其具有三種形式，然後提供下列名稱：
- 導覽
- NewCustomer
- FillOrCancel
為每個表單加入下圖中顯示的文字方塊、按鈕和其他控制項。對每個控制項設定資料表描述的屬性。

注意

加入群組方塊和標籤控制項會更清楚，但是不在程式碼中使用。

巡覽表單

瀏覽表單的控制項	屬性
Button	Name = btnGoToAdd
Button	Name = btnGoToFillOrCancel
Button	Name = btnExit

NewCustomer 表單

新增客戶以及下訂單

NewCustomer 表單的控制項	屬性
TextBox	Name = txtCustomerName
TextBox	Name = txtCustomerID Readonly = True
Button	Name = btnCreateAccount
NumericUpdown	DecimalPlaces = 0 Maximum = 5000 Name = numOrderAmount
DateTimePicker	Format = Short Name = dtpOrderDate
Button	Name = btnPlaceOrder
Button	Name = btnAddAnotherAccount
Button	Name = btnAddFinish

FillOrCancel 表單

填寫或取消訂單

FillOrCancel 表單的控制項	屬性
TextBox	Name = txtOrderID
Button	Name = btnFindByOrderID
DateTimePicker	Format = Short Name = dtpFillDate
DataGridView	Name = dgvCustomerOrders Readonly = True RowHeadersVisible = False
Button	Name = btnCancelOrder
Button	Name = btnFillOrder
Button	Name = btnFinishUpdates

儲存連接字串

當您的應用程式嘗試開啟資料庫的連接時，應用程式必須存取連接字串。若要避免在每個表單上手動輸入字串，請將字串儲存在專案的 App.config 檔案中，並建立方法以在方法從應用程式中的任何表單呼叫時傳回字串。

您可以在 [伺服器總管] 中的 [銷售] 資料連線上按一下滑鼠右鍵，然後選擇 [屬性] 來尋找連接字串。找出 ConnectionString 屬性，然後使用 Ctrl+A、Ctrl+C 來選取字串，並將字串複製到剪貼簿。

如果您使用 C#，請在 [方案總管] 中，展開專案底下的 [屬性] 節點，然後開啟 Settings.settings 檔案。如果您使用 Visual Basic，請在 [方案總管] 中，按一下 [顯示所有檔案]、展開 [我的專案] 節點，然後開啟 Settings.settings 檔案。
在 [名稱] 資料行中，輸入 connString。
在 [類型] 清單中，選取 [(連接字串)]。
在 [範圍] 清單中，選取 [應用程式]。
在 [值] 資料行中，輸入您的連接字串 (不含任何外部引號)，然後儲存您的變更。

注意

在實際的應用程式中，您應該安全地儲存連接字串，如連接字串和組態檔中所述。

撰寫表單的程式碼

本節包含每個表單用途的簡短概觀。其中也提供程式碼，可在按一下表單上的按鈕時定義基礎邏輯。

當您執行應用程式時，瀏覽表單隨即開啟。 [新增帳戶] 按鈕會開啟 NewCustomer 表單。 [填寫或取消訂單] 按鈕會開啟 FillOrCancel 表單。 [結束] 按鈕會關閉應用程式。

如果您使用 C#，在 [方案總管] 中開啟 Program.cs，然後將 Application.Run 這一行變更如下：Application.Run(new Navigation());

如果您使用 Visual Basic，在 [方案總管] 中開啟 [屬性] 視窗，選取 [應用程式] 索引標籤，然後在 [啟動表單] 清單上選取 SimpleDataApp.Navigation。

建立自動產生的事件處理常式

按兩下瀏覽表單上的三個按鈕，以建立空的事件處理常式方法。按兩下按鈕也會在設計工具程式碼檔案中新增自動產生的程式碼，可讓按鈕按一下以引發事件。

注意

如果您略過設計工具中的按兩下動作，且只複製程式碼並貼到程式碼檔案中，別忘了將事件處理常式設定為正確的方法。您可以在 [屬性] 視窗中執行此動作。切換至 [事件] 索引標籤 (使用閃電工具列按鈕)，並尋找 Click 處理常式。

在瀏覽表單的字碼頁中，完成三個按鈕 Click 事件處理常式的方法本文，如下列程式碼所示。

/// <summary>
/// Opens the NewCustomer form as a dialog box,
/// which returns focus to the calling form when it is closed. 
/// </summary>
private void btnGoToAdd_Click(object sender, EventArgs e)
{
    Form frm = new NewCustomer();
    frm.Show();
}

/// <summary>
/// Opens the FillorCancel form as a dialog box. 
/// </summary>
private void btnGoToFillOrCancel_Click(object sender, EventArgs e)
{
    Form frm = new FillOrCancel();
    frm.ShowDialog();
}

/// <summary>
/// Closes the application (not just the Navigation form).
/// </summary>
private void btnExit_Click(object sender, EventArgs e)
{
    this.Close();
}

''' <summary>
''' Opens the NewCustomer form as a dialog box, which returns focus to the calling form when it closes.
''' </summary>  
Private Sub btnGoToAdd_Click(sender As Object, e As EventArgs) Handles btnGoToAdd.Click
    Dim frm As Form = New NewCustomer()
    frm.Show()
End Sub

''' <summary>
''' Opens the FillOrCancel form as a dialog box.
''' </summary>
Private Sub btnGoToFillOrCancel_Click(sender As Object, e As EventArgs) Handles btnGoToFillOrCancel.Click
    Dim frm As Form = New FillOrCancel()
    frm.ShowDialog()
End Sub

''' <summary>
''' Closes the application (not just the navigation form).
''' </summary>
Private Sub btnExit_Click(sender As Object, e As EventArgs) Handles btnExit.Click
    Me.Close()
End Sub

注意

本教學課程的程式碼適用於 C# 和 Visual Basic。若要將此頁面上的程式碼語言在 C# 與 Visual Basic 之間切換，請使用每個程式碼範例頂端的程式碼語言切換器。

NewCustomer 表單

當您輸入客戶名稱，然後選取 [建立帳戶] 按鈕時，NewCustomer 表單會建立客戶帳戶，SQL Server 會傳回 IDENTITY 值做為新的客戶識別碼。然後您可以排序新帳戶，方法是指定數量和訂單日期，然後選取 [訂購] 按鈕。

建立自動產生的事件處理常式

按兩下這四個按鈕的每一個按鈕，為 NewCustomer 表單上的每個按鈕建立空的 Click 事件處理常式。按兩下按鈕也會在設計工具程式碼檔案中新增自動產生的程式碼，可讓按鈕按一下以引發事件。

新增 NewCustomer 表單邏輯的程式碼

若要完成 NewCustomer 表單邏輯，請遵循下列步驟。

將 System.Data.SqlClient 命名空間帶入範圍，讓您不需要完全符合其成員的名稱。
- C#
- VB
```
using System.Data.SqlClient;
```
```
Imports System.Data.SqlClient
```

將一些變數和協助程式方法新增至類別，如下列程式碼所示。

// Storage for IDENTITY values returned from database.
private int parsedCustomerID;
private int orderID;

/// <summary>
/// Verifies that the customer name text box is not empty.
/// </summary>
private bool IsCustomerNameValid()
{
    if (txtCustomerName.Text == "")
    {
        MessageBox.Show("Please enter a name.");
        return false;
    }
    else
    {
        return true;
    }
}

/// <summary>
/// Verifies that a customer ID and order amount have been provided.
/// </summary>
private bool IsOrderDataValid()
{
    // Verify that CustomerID is present.
    if (txtCustomerID.Text == "")
    {
        MessageBox.Show("Please create customer account before placing order.");
        return false;
    }
    // Verify that Amount isn't 0.
    else if ((numOrderAmount.Value < 1))
    {
        MessageBox.Show("Please specify an order amount.");
        return false;
    }
    else
    {
        // Order can be submitted.
        return true;
    }
}

/// <summary>
/// Clears the form data.
/// </summary>
private void ClearForm()
{
    txtCustomerName.Clear();
    txtCustomerID.Clear();
    dtpOrderDate.Value = DateTime.Now;
    numOrderAmount.Value = 0;
    this.parsedCustomerID = 0;
}

' Storage for ID values returned from the database.  
Private parsedCustomerID As Integer
Private orderID As Integer

''' <summary>
''' Verifies that the customer name text box is not empty.
''' </summary>
Private ReadOnly Property IsCustomerNameValid As Boolean
    Get
        If txtCustomerName.Text = "" Then
            MessageBox.Show("Please enter a name.")
            Return False
        Else
            Return True
        End If
    End Get
End Property

''' <summary>
''' Verifies the order data is valid. 
''' </summary>
Private Function IsOrderDataValid() As Boolean

    ' Verify that CustomerID is present.  
    If txtCustomerID.Text = "" Then
        MessageBox.Show("Please create a customer account before placing order.")
        Return False

        ' Verify that order amount isn't 0.   
    ElseIf (numOrderAmount.Value < 1) Then
        MessageBox.Show("Please specify an order amount.")
        Return False
    Else
        ' Order can be submitted.  
        Return True
    End If
End Function

''' <summary>
''' Clears values from controls.
''' </summary>
Private Sub ClearForm()
    txtCustomerName.Clear()
    txtCustomerID.Clear()
    dtpOrderDate.Value = DateTime.Now
    numOrderAmount.Value = 0
    Me.parsedCustomerID = 0
End Sub

完成四個按鈕 Click 事件處理常式的方法本文，如下列程式碼所示。

/// <summary>
/// Creates a new customer by calling the Sales.uspNewCustomer stored procedure.
/// </summary>
private void btnCreateAccount_Click(object sender, EventArgs e)
{
    if (IsCustomerNameValid())
    {
        // Create the connection.
        using (SqlConnection connection = new SqlConnection(Properties.Settings.Default.connString))
        {
            // Create a SqlCommand, and identify it as a stored procedure.
            using (SqlCommand sqlCommand = new SqlCommand("Sales.uspNewCustomer", connection))
            {
                sqlCommand.CommandType = CommandType.StoredProcedure;

                // Add input parameter for the stored procedure and specify what to use as its value.
                sqlCommand.Parameters.Add(new SqlParameter("@CustomerName", SqlDbType.NVarChar, 40));
                sqlCommand.Parameters["@CustomerName"].Value = txtCustomerName.Text;

                // Add the output parameter.
                sqlCommand.Parameters.Add(new SqlParameter("@CustomerID", SqlDbType.Int));
                sqlCommand.Parameters["@CustomerID"].Direction = ParameterDirection.Output;

                try
                {
                    connection.Open();

                    // Run the stored procedure.
                    sqlCommand.ExecuteNonQuery();

                    // Customer ID is an IDENTITY value from the database.
                    this.parsedCustomerID = (int)sqlCommand.Parameters["@CustomerID"].Value;

                    // Put the Customer ID value into the read-only text box.
                    this.txtCustomerID.Text = Convert.ToString(parsedCustomerID);
                }
                catch
                {
                    MessageBox.Show("Customer ID was not returned. Account could not be created.");
                }
                finally
                {
                    connection.Close();
                }
            }
        }
    }
}

/// <summary>
/// Calls the Sales.uspPlaceNewOrder stored procedure to place an order.
/// </summary>
private void btnPlaceOrder_Click(object sender, EventArgs e)
{
    // Ensure the required input is present.
    if (IsOrderDataValid())
    {
        // Create the connection.
        using (SqlConnection connection = new SqlConnection(Properties.Settings.Default.connString))
        {
            // Create SqlCommand and identify it as a stored procedure.
            using (SqlCommand sqlCommand = new SqlCommand("Sales.uspPlaceNewOrder", connection))
            {
                sqlCommand.CommandType = CommandType.StoredProcedure;

                // Add the @CustomerID input parameter, which was obtained from uspNewCustomer.
                sqlCommand.Parameters.Add(new SqlParameter("@CustomerID", SqlDbType.Int));
                sqlCommand.Parameters["@CustomerID"].Value = this.parsedCustomerID;

                // Add the @OrderDate input parameter.
                sqlCommand.Parameters.Add(new SqlParameter("@OrderDate", SqlDbType.DateTime, 8));
                sqlCommand.Parameters["@OrderDate"].Value = dtpOrderDate.Value;

                // Add the @Amount order amount input parameter.
                sqlCommand.Parameters.Add(new SqlParameter("@Amount", SqlDbType.Int));
                sqlCommand.Parameters["@Amount"].Value = numOrderAmount.Value;

                // Add the @Status order status input parameter.
                // For a new order, the status is always O (open).
                sqlCommand.Parameters.Add(new SqlParameter("@Status", SqlDbType.Char, 1));
                sqlCommand.Parameters["@Status"].Value = "O";

                // Add the return value for the stored procedure, which is  the order ID.
                sqlCommand.Parameters.Add(new SqlParameter("@RC", SqlDbType.Int));
                sqlCommand.Parameters["@RC"].Direction = ParameterDirection.ReturnValue;

                try
                {
                    //Open connection.
                    connection.Open();

                    // Run the stored procedure.
                    sqlCommand.ExecuteNonQuery();

                    // Display the order number.
                    this.orderID = (int)sqlCommand.Parameters["@RC"].Value;
                    MessageBox.Show("Order number " + this.orderID + " has been submitted.");
                }
                catch
                {
                    MessageBox.Show("Order could not be placed.");
                }
                finally
                {
                    connection.Close();
                }
            }
        }
    }
}

/// <summary>
/// Clears the form data so another new account can be created.
/// </summary>
private void btnAddAnotherAccount_Click(object sender, EventArgs e)
{
    this.ClearForm();
}

/// <summary>
/// Closes the form/dialog box.
/// </summary>
private void btnAddFinish_Click(object sender, EventArgs e)
{
    this.Close();
}

''' <summary>
''' Creates a new account by executing the Sales.uspNewCustomer
''' stored procedure on the database.
''' </summary>
Private Sub btnCreateAccount_Click(sender As Object, e As EventArgs) Handles btnCreateAccount.Click

    ' Ensure a customer name has been entered.
    If IsCustomerNameValid Then

        ' Create the SqlConnection object. 
        Using connection As New SqlConnection(My.Settings.connString)

            ' Create a SqlCommand, and identify the command type as a stored procedure.  
            Using sqlCommand As New SqlCommand("Sales.uspNewCustomer", connection)
                sqlCommand.CommandType = CommandType.StoredProcedure

                ' Add the customer name input parameter for the stored procedure.  
                sqlCommand.Parameters.Add(New SqlParameter("@CustomerName", SqlDbType.NVarChar, 40))
                sqlCommand.Parameters("@CustomerName").Value = txtCustomerName.Text

                ' Add the customer ID output parameter.  
                sqlCommand.Parameters.Add(New SqlParameter("@CustomerID", SqlDbType.Int))
                sqlCommand.Parameters("@CustomerID").Direction = ParameterDirection.Output

                Try
                    ' Open the connection.  
                    connection.Open()

                    ' Run the stored procedure.  
                    sqlCommand.ExecuteNonQuery()

                    ' Convert the Customer ID value to an Integer.   
                    Me.parsedCustomerID = CInt(sqlCommand.Parameters("@CustomerID").Value)

                    ' Insert the customer ID into the corresponding text box.
                    Me.txtCustomerID.Text = Convert.ToString(parsedCustomerID)
                Catch
                    MessageBox.Show("Customer ID was not returned. Account could not be created.")
                Finally
                    ' Close the connection.  
                    connection.Close()
                End Try
            End Using
        End Using
    End If
End Sub

''' <summary>
''' Places the order by executing the Sales.uspPlaceNewOrder
''' stored procedure on the database.
''' </summary>
Private Sub btnPlaceOrder_Click(sender As Object, e As EventArgs) Handles btnPlaceOrder.Click

    If IsOrderDataValid() Then

        ' Create the connection.  
        Using connection As New SqlConnection(My.Settings.connString)

            ' Create SqlCommand and identify it as a stored procedure.  
            Using sqlCommand As New SqlCommand("Sales.uspPlaceNewOrder", connection)
                sqlCommand.CommandType = CommandType.StoredProcedure

                ' Add the @CustomerID parameter, which was an output parameter from uspNewCustomer.  
                sqlCommand.Parameters.Add(New SqlParameter("@CustomerID", SqlDbType.Int))
                sqlCommand.Parameters("@CustomerID").Value = Me.parsedCustomerID

                ' Add the @OrderDate parameter.  
                sqlCommand.Parameters.Add(New SqlParameter("@OrderDate", SqlDbType.DateTime, 8))
                sqlCommand.Parameters("@OrderDate").Value = dtpOrderDate.Value

                ' Add the @Amount parameter.  
                sqlCommand.Parameters.Add(New SqlParameter("@Amount", SqlDbType.Int))
                sqlCommand.Parameters("@Amount").Value = numOrderAmount.Value

                ' Add the @Status parameter. For a new order, the status is always O (open).  
                sqlCommand.Parameters.Add(New SqlParameter("@Status", SqlDbType.[Char], 1))
                sqlCommand.Parameters("@Status").Value = "O"

                ' Add a return value parameter for the stored procedure, which is the orderID.  
                sqlCommand.Parameters.Add(New SqlParameter("@RC", SqlDbType.Int))
                sqlCommand.Parameters("@RC").Direction = ParameterDirection.ReturnValue

                Try
                    ' Open connection.  
                    connection.Open()

                    ' Run the stored procedure.  
                    sqlCommand.ExecuteNonQuery()

                    ' Display the order number.  
                    Me.orderID = CInt(sqlCommand.Parameters("@RC").Value)
                    MessageBox.Show("Order number " & (Me.orderID).ToString & " has been submitted.")
                Catch
                    ' A simple catch.  
                    MessageBox.Show("Order could  not be placed.")
                Finally
                    ' Always close a connection after you finish using it,
                    ' so that it can be released to the connection pool.
                    connection.Close()
                End Try
            End Using
        End Using
    End If
End Sub

''' <summary>
''' Resets the form for another new account.
''' </summary>
Private Sub btnAddAnotherAccount_Click(sender As Object, e As EventArgs) Handles btnAddAnotherAccount.Click
    Me.ClearForm()
End Sub

''' <summary>
''' Closes the NewCustomer form and returns focus to the Navigation form.
''' </summary>
Private Sub btnAddFinish_Click(sender As Object, e As EventArgs) Handles btnAddFinish.Click
    Me.Close()
End Sub

FillOrCancel 表單

當您輸入訂單 ID，然後選取 [尋找訂單] 按鈕時，FillorCancel 表單會執行查詢來傳回訂單。傳回的資料列會顯示在唯讀的資料格。如果您選取 [取消訂單] 按鈕，可以將訂單標示為已取消 (X)，或者如果您選取 [填寫訂單] 按鈕，可以將訂單標示為已填寫 (F)。如果您再次選取 [尋找訂單] 按鈕，則會顯示更新的資料列。

建立自動產生的事件處理常式

按兩下按鈕，為 FillOrCancel 表單上的四個按鈕建立空的 Click 事件處理常式。按兩下按鈕也會在設計工具程式碼檔案中新增自動產生的程式碼，可讓按鈕按一下以引發事件。

新增 FillOrCancel 表單邏輯的程式碼

若要完成 FillOrCancel 表單邏輯，請遵循下列步驟。

將下列兩個命名空間帶入範圍，讓您不需要完全符合其成員的名稱。

using System.Data.SqlClient;
using System.Text.RegularExpressions;

Imports System.Data.SqlClient
Imports System.Text.RegularExpressions

將變數和協助程式方法新增至類別，如下列程式碼所示。

// Storage for the order ID value.
private int parsedOrderID;

/// <summary>
/// Verifies that an order ID is present and contains valid characters.
/// </summary>
private bool IsOrderIDValid()
{
    // Check for input in the Order ID text box.
    if (txtOrderID.Text == "")
    {
        MessageBox.Show("Please specify the Order ID.");
        return false;
    }

    // Check for characters other than integers.
    else if (Regex.IsMatch(txtOrderID.Text, @"^\D*$"))
    {
        // Show message and clear input.
        MessageBox.Show("Customer ID must contain only numbers.");
        txtOrderID.Clear();
        return false;
    }
    else
    {
        // Convert the text in the text box to an integer to send to the database.
        parsedOrderID = Int32.Parse(txtOrderID.Text);
        return true;
    }
}

' Storage for OrderID.  
Private parsedOrderID As Integer

''' <summary>
''' Verifies that OrderID is valid.
''' </summary>
Private Function IsOrderIDValid() As Boolean

    ' Check for input in the Order ID text box.  
    If txtOrderID.Text = "" Then
        MessageBox.Show("Please specify the Order ID.")
        Return False

        ' Check for characters other than integers.  
    ElseIf Regex.IsMatch(txtOrderID.Text, "^\D*$") Then
        ' Show message and clear input.  
        MessageBox.Show("Please specify integers only.")
        txtOrderID.Clear()
        Return False
    Else
        ' Convert the text in the text box to an integer to send to the database.  
        parsedOrderID = Int32.Parse(txtOrderID.Text)
        Return True
    End If
End Function

完成四個按鈕 Click 事件處理常式的方法本文，如下列程式碼所示。

/// <summary>
/// Executes a t-SQL SELECT statement to obtain order data for a specified
/// order ID, then displays it in the DataGridView on the form.
/// </summary>
private void btnFindByOrderID_Click(object sender, EventArgs e)
{
    if (IsOrderIDValid())
    {
        using (SqlConnection connection = new SqlConnection(Properties.Settings.Default.connString))
        {
            // Define a t-SQL query string that has a parameter for orderID.
            const string sql = "SELECT * FROM Sales.Orders WHERE orderID = @orderID";

            // Create a SqlCommand object.
            using (SqlCommand sqlCommand = new SqlCommand(sql, connection))
            {
                // Define the @orderID parameter and set its value.
                sqlCommand.Parameters.Add(new SqlParameter("@orderID", SqlDbType.Int));
                sqlCommand.Parameters["@orderID"].Value = parsedOrderID;

                try
                {
                    connection.Open();

                    // Run the query by calling ExecuteReader().
                    using (SqlDataReader dataReader = sqlCommand.ExecuteReader())
                    {
                        // Create a data table to hold the retrieved data.
                        DataTable dataTable = new DataTable();

                        // Load the data from SqlDataReader into the data table.
                        dataTable.Load(dataReader);

                        // Display the data from the data table in the data grid view.
                        this.dgvCustomerOrders.DataSource = dataTable;

                        // Close the SqlDataReader.
                        dataReader.Close();
                    }
                }
                catch
                {
                    MessageBox.Show("The requested order could not be loaded into the form.");
                }
                finally
                {
                    // Close the connection.
                    connection.Close();
                }
            }
        }
    }
}

/// <summary>
/// Cancels an order by calling the Sales.uspCancelOrder
/// stored procedure on the database.
/// </summary>
private void btnCancelOrder_Click(object sender, EventArgs e)
{
    if (IsOrderIDValid())
    {
        // Create the connection.
        using (SqlConnection connection = new SqlConnection(Properties.Settings.Default.connString))
        {
            // Create the SqlCommand object and identify it as a stored procedure.
            using (SqlCommand sqlCommand = new SqlCommand("Sales.uspCancelOrder", connection))
            {
                sqlCommand.CommandType = CommandType.StoredProcedure;

                // Add the order ID input parameter for the stored procedure.
                sqlCommand.Parameters.Add(new SqlParameter("@orderID", SqlDbType.Int));
                sqlCommand.Parameters["@orderID"].Value = parsedOrderID;

                try
                {
                    // Open the connection.
                    connection.Open();

                    // Run the command to execute the stored procedure.
                    sqlCommand.ExecuteNonQuery();
                }
                catch
                {
                    MessageBox.Show("The cancel operation was not completed.");
                }
                finally
                {
                    // Close connection.
                    connection.Close();
                }
            }
        }
    }
}

/// <summary>
/// Fills an order by calling the Sales.uspFillOrder stored
/// procedure on the database.
/// </summary>
private void btnFillOrder_Click(object sender, EventArgs e)
{
    if (IsOrderIDValid())
    {
        // Create the connection.
        using (SqlConnection connection = new SqlConnection(Properties.Settings.Default.connString))
        {
            // Create command and identify it as a stored procedure.
            using (SqlCommand sqlCommand = new SqlCommand("Sales.uspFillOrder", connection))
            {
                sqlCommand.CommandType = CommandType.StoredProcedure;

                // Add the order ID input parameter for the stored procedure.
                sqlCommand.Parameters.Add(new SqlParameter("@orderID", SqlDbType.Int));
                sqlCommand.Parameters["@orderID"].Value = parsedOrderID;

                // Add the filled date input parameter for the stored procedure.
                sqlCommand.Parameters.Add(new SqlParameter("@FilledDate", SqlDbType.DateTime, 8));
                sqlCommand.Parameters["@FilledDate"].Value = dtpFillDate.Value;

                try
                {
                    connection.Open();

                    // Execute the stored procedure.
                    sqlCommand.ExecuteNonQuery();
                }
                catch
                {
                    MessageBox.Show("The fill operation was not completed.");
                }
                finally
                {
                    // Close the connection.
                    connection.Close();
                }
            }
        }
    }
}

/// <summary>
/// Closes the form.
/// </summary>
private void btnFinishUpdates_Click(object sender, EventArgs e)
{
    this.Close();
}

''' <summary>
''' Executes a t-SQL SELECT query on the database to
''' obtain order data for a specified order ID.
''' </summary>
Private Sub btnFindByOrderID_Click(sender As Object, e As EventArgs) Handles btnFindByOrderID.Click

    ' Prepare the connection and the command.
    If IsOrderIDValid() Then

        ' Create the connection.  
        Using connection As New SqlConnection(My.Settings.connString)

            ' Define the query string that has a parameter for orderID.  
            Const sql As String = "select * from Sales.Orders where orderID = @orderID"

            ' Create a SqlCommand object.  
            Using sqlCommand As New SqlCommand(sql, connection)

                ' Define the @orderID parameter and its value.  
                sqlCommand.Parameters.Add(New SqlParameter("@orderID", SqlDbType.Int))
                sqlCommand.Parameters("@orderID").Value = parsedOrderID

                Try
                    ' Open connection.  
                    connection.Open()

                    ' Execute the query.  
                    Dim dataReader As SqlDataReader = sqlCommand.ExecuteReader()

                    ' Create a data table to hold the retrieved data.  
                    Dim dataTable As New DataTable()

                    ' Load the data from SqlDataReader into the data table.  
                    dataTable.Load(dataReader)

                    ' Display the data from the data table in the data grid view.  
                    Me.dgvCustomerOrders.DataSource = dataTable

                    ' Close the SqlDataReader.  
                    dataReader.Close()
                Catch
                    MessageBox.Show("The requested order could not be loaded into the form.")
                Finally
                    ' Close the connection.  
                    connection.Close()
                End Try
            End Using
        End Using
    End If
End Sub

''' <summary>
''' Fills an order by running the Sales.uspFillOrder stored procedure on the database.
''' </summary>
Private Sub btnFillOrder_Click(sender As Object, e As EventArgs) Handles btnFillOrder.Click

    ' Set up and run stored procedure only if OrderID is valid.  
    If IsOrderIDValid() Then

        ' Create the connection. 
        Using connection As New SqlConnection(My.Settings.connString)

            ' Create command and identify it as a stored procedure.  
            Using sqlCommand As New SqlCommand("Sales.uspFillOrder", connection)

                sqlCommand.CommandType = CommandType.StoredProcedure

                ' Add input parameter for the stored procedure.  
                sqlCommand.Parameters.Add(New SqlParameter("@orderID", SqlDbType.Int))
                sqlCommand.Parameters("@orderID").Value = parsedOrderID

                ' Add second input parameter.  
                sqlCommand.Parameters.Add(New SqlParameter("@FilledDate", SqlDbType.DateTime, 8))
                sqlCommand.Parameters("@FilledDate").Value = dtpFillDate.Value

                Try
                    ' Open the connection.  
                    connection.Open()

                    ' Run the SqlCommand.   
                    sqlCommand.ExecuteNonQuery()
                Catch
                    ' A simple catch.  
                    MessageBox.Show("The fill operation was not completed.")
                Finally
                    ' Close the connection.  
                    connection.Close()
                End Try
            End Using
        End Using
    End If
End Sub

''' <summary>
''' Cancels an order by running the Sales.uspCancelOrder stored procedure on the database.
''' </summary>
Private Sub btnCancelOrder_Click(sender As Object, e As EventArgs) Handles btnCancelOrder.Click

    ' Set up and run the stored procedure only if OrderID is ready.  
    If IsOrderIDValid() Then

        ' Create the connection. 
        Using connection As New SqlConnection(My.Settings.connString)

            ' Create the command and identify it as a stored procedure.  
            Using sqlCommand As New SqlCommand("Sales.uspCancelOrder", connection)
                sqlCommand.CommandType = CommandType.StoredProcedure

                ' Add input parameter for the stored procedure.  
                sqlCommand.Parameters.Add(New SqlParameter("@orderID", SqlDbType.Int))
                sqlCommand.Parameters("@orderID").Value = parsedOrderID

                Try
                    ' Open the connection.  
                    connection.Open()

                    ' Run the SqlCommand.  
                    sqlCommand.ExecuteNonQuery()
                Catch
                    ' A simple catch.  
                    MessageBox.Show("The cancel operation was not completed.")
                Finally
                    ' Close connection.  
                    connection.Close()
                End Try
            End Using
        End Using
    End If
End Sub

''' <summary>
''' Closes the form and returns focus to the Navigation form.
''' </summary>
Private Sub btnFinishUpdates_Click(sender As Object, e As EventArgs) Handles btnFinishUpdates.Click
    Me.Close()
End Sub

測試您的應用程式

執行應用程式，並嘗試建立一些客戶和訂單，以確認一切如預期般運作。若要確認資料庫已隨著變更而更新，請在 [伺服器總管] 中開啟 [資料表] 節點，以滑鼠右鍵按一下 [客戶] 和 [訂單] 節點，然後選擇 [顯示資料表資料]。

適用於 .NET 的 Visual Studio Data Tools

使用 ADO.NET 建立簡單的資料應用程式

必要條件

設定範例資料庫

建立表單並加入控制項

儲存連接字串

撰寫表單的程式碼

導覽表單

讓瀏覽表單成為啟動表單

建立自動產生的事件處理常式

新增導覽表單邏輯的程式碼

NewCustomer 表單

建立自動產生的事件處理常式

新增 NewCustomer 表單邏輯的程式碼

FillOrCancel 表單

建立自動產生的事件處理常式

新增 FillOrCancel 表單邏輯的程式碼

測試您的應用程式

意見反應

意見反應

其他資源

使用 ADO.NET 建立簡單的資料應用程式

必要條件

設定範例資料庫

建立表單並加入控制項

儲存連接字串

撰寫表單的程式碼

導覽表單

讓瀏覽表單成為啟動表單

建立自動產生的事件處理常式

新增導覽表單邏輯的程式碼

NewCustomer 表單

建立自動產生的事件處理常式

新增 NewCustomer 表單邏輯的程式碼

FillOrCancel 表單

建立自動產生的事件處理常式

新增 FillOrCancel 表單邏輯的程式碼

測試您的應用程式

相關內容

意見反應

意見反應

其他資源