共用方式為


逐步解說:操作資料 (C#)

本逐步解說針對新增、修改和刪除資料庫中的資料,提供基本的端對端 LINQ to SQL 案例。 您將使用範例 Northwind 資料庫的複本來加入客戶、變更客戶名稱,以及刪除訂單。

注意

在下列指示的某些 Visual Studio 使用者介面項目中,您的電腦可能會顯示不同的名稱或位置: 您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。 如需詳細資訊,請參閱將 Visual Studio IDE 個人化

本逐步解說的內容是依據 Visual C# 開發設定所撰寫的。

必要條件

本逐步解說需要下列項目:

  • 本逐步解說會使用專用資料夾 ("c:\linqtest6") 來保存檔案。 請先建立這個資料夾,再開始逐步解說。

  • Northwind 範例資料庫。

    如果您的開發電腦上沒有這個資料庫,則可以從 Microsoft 下載網站下載。 如需相關指示,請參閱下載範例資料庫。 下載資料庫之後,請將 northwnd.mdf 檔案複製至 c:\linqtest6 資料夾。

  • 會從 Northwind 資料庫產生 C# 程式碼檔案。

    您可以使用物件關聯式設計工具或 SQLMetal 工具來產生這個檔案。 本逐步解說是使用 SQLMetal 工具,以下列命令列所撰寫:

    sqlmetal /code:"c:\linqtest6\northwind.cs" /language:csharp "C:\linqtest6\northwnd.mdf" /pluralize

    如需詳細資訊,請參閱 SqlMetal.exe (程式碼產生工具)

概觀

此逐步解說包含六個主要工作:

  • 在 Visual Studio 中建立 LINQ to SQL 解決方案。

  • 將資料庫程式碼檔案加入至專案。

  • 建立新的客戶物件。

  • 修改客戶的連絡人名稱。

  • 刪除訂單。

  • 將這些變更送出至 Northwind 資料庫。

建立 LINQ to SQL 方案

在第一項工作中,您會建立一個 Visual Studio 解方案,其中包含建置與執行 LINQ to SQL 專案所需的參考。

若要建立 LINQ to SQL 方案

  1. 在 Visual Studio [檔案] 功能表上,指向 [新增],然後按一下 [專案]

  2. 在 [新增專案] 對話方塊的 [專案類型] 窗格中,按一下 [Visual C#]

  3. 按一下 [範本] 窗格中的 [主控台應用程式]

  4. 在 [名稱] 方塊中,輸入 LinqDataManipulationApp

  5. 在 [位置] 方塊中,確認您要儲存專案檔的位置。

  6. 按一下 [確定]

加入 LINQ 參考和指示詞

本逐步解說使用的組件,可能在您的專案中預設為不安裝。 如果 System.Data.Linq 未列為專案中的參考,請按照下列步驟所述將它加入:

若要加入 System.Data.Linq

  1. 在 [方案總管] 中,以滑鼠右鍵按一下 [參考],然後按一下 [新增參考]

  2. 按一下 [加入參考] 對話方塊中的 [.NET],然後按一下 System.Data.Linq 組件,再按一下 [確定]

    組件隨即加入至專案。

  3. 將下列指示詞加在 Program.cs 的上方:

    using System.Data.Linq;
    using System.Data.Linq.Mapping;
    

將 Northwind 程式碼檔案加入至專案

這些步驟假設您已使用 SQLMetal 工具,從 Northwind 範例資料庫產生程式碼檔案。 如需詳細資訊,請參閱本逐步解說稍早的「必要條件」一節。

若要將 Northwind 程式碼檔案加入至專案

  1. 在 [專案] 功能表上,按一下 [新增現有項目]

  2. 在 [新增現有項目] 對話方塊中,瀏覽至 c:\linqtest6\northwind.cs,然後按一下 [新增]

    northwind.cs 檔案會加入至專案。

設定資料庫連接

請先測試與資料庫的連接。 請特別注意,資料庫 Northwnd 沒有字母 i。 如果在後續步驟發生錯誤,則請檢閱 northwind.cs 檔案,以判斷 Northwind 部分類別的拼法。

若要設定和測試資料庫連接

  1. 將下列程式碼輸入或貼入 Program 類別的 Main 方法:

    // Use the following connection string.
    Northwnd db = new Northwnd(@"c:\linqtest6\northwnd.mdf");
    
    // Keep the console window open after activity stops.
    Console.ReadLine();
    
  2. 按 F5,立即測試應用程式。

    [主控台] 視窗隨即開啟。

    您可以在 [主控台] 視窗中按 Enter 鍵,或按一下 Visual Studio [偵錯] 功能表上的 [停止偵錯],來關閉應用程式。

建立新的實體

建立新的實體十分簡單。 您可以使用 Customer 關鍵字,建立物件 (如 new)。

在本節和下列各節中,您變更的只是本機快取。 在本逐步解說最後呼叫 SubmitChanges 之前,都不會將變更傳送至資料庫。

若要加入新的 Customer 實體物件

  1. Customer 方法的 Console.ReadLine(); 前面加入下列程式碼,建立新的 Main

    // Create the new Customer object.
    Customer newCust = new Customer();
    newCust.CompanyName = "AdventureWorks Cafe";
    newCust.CustomerID = "ADVCA";
    
    // Add the customer to the Customers table.
    db.Customers.InsertOnSubmit(newCust);
    
    Console.WriteLine("\nCustomers matching CA before insert");
    
    foreach (var c in db.Customers.Where(cust => cust.CustomerID.Contains("CA")))
    {
        Console.WriteLine("{0}, {1}, {2}",
            c.CustomerID, c.CompanyName, c.Orders.Count);
    }
    
  2. 按 F5 對方案進行偵錯。

  3. 在 [主控台] 視窗中按 Enter 鍵,以停止偵錯並繼續逐步解說。

更新實體

在下列步驟中,您會擷取 Customer 物件,並修改它的其中一個屬性。

若要變更 Customer 的名稱

  • 將下列程式碼加入至 Console.ReadLine(); 的上方:

    // Query for specific customer.
    // First() returns one object rather than a collection.
    var existingCust =
        (from c in db.Customers
         where c.CustomerID == "ALFKI"
         select c)
        .First();
    
    // Change the contact name of the customer.
    existingCust.ContactName = "New Contact";
    

刪除實體

您可以使用同一個客戶物件,刪除第一份訂單。

在下列程式碼中,會示範如何中斷資料列之間的關聯性 (Relationship),以及如何刪除資料庫中的資料列。 將下列程式碼加入至 Console.ReadLine 的前面,以查看如何刪除物件:

若要刪除資料列

  • 將下列程式碼加入至 Console.ReadLine(); 的正上方:

    // Access the first element in the Orders collection.
    Order ord0 = existingCust.Orders[0];
    
    // Access the first element in the OrderDetails collection.
    OrderDetail detail0 = ord0.OrderDetails[0];
    
    // Display the order to be deleted.
    Console.WriteLine
        ("The Order Detail to be deleted is: OrderID = {0}, ProductID = {1}",
        detail0.OrderID, detail0.ProductID);
    
    // Mark the Order Detail row for deletion from the database.
    db.OrderDetails.DeleteOnSubmit(detail0);
    

將變更送出至資料庫

建立、更新和刪除物件的最終必要步驟是實際將變更送出至資料庫。 沒有這個步驟,所進行的變更只是針對本機,並不會出現在查詢結果中。

若要將變更送出至資料庫

  1. 將下列程式碼插入至 Console.ReadLine 的正上方:

    db.SubmitChanges();
    
  2. 將下列程式碼插入至 SubmitChanges 的後面,以顯示送出變更之前和之後的效果:

    Console.WriteLine("\nCustomers matching CA after update");
    foreach (var c in db.Customers.Where(cust =>
        cust.CustomerID.Contains("CA")))
    {
        Console.WriteLine("{0}, {1}, {2}",
            c.CustomerID, c.CompanyName, c.Orders.Count);
    }
    
  3. 按 F5 對方案進行偵錯。

  4. 在 [主控台] 視窗中按 Enter 鍵,以關閉應用程式。

注意

送出變更以加入新的客戶之後,無法再照原狀執行這個方案。 若要重新執行方案,請變更要加入的客戶名稱和客戶識別碼。

另請參閱