Пошаговое руководство. Обработка данных (C#) (LINQ to SQL)

  • Статья

В данном руководстве представлен основной и полный сценарий LINQ to SQL по добавлению, изменению и удалению данных в базе данных. Для добавления клиента, изменения его имени и удаления заказа следует использовать копию учебной базы данных Northwind.

ПримечаниеПримечание

На вашем компьютере названия некоторых элементов интерфейса пользователя Visual Studio или их расположение могут отличаться от указанных в нижеследующих инструкциях. Это зависит от имеющегося выпуска Visual Studio и используемых параметров. Дополнительные сведения см. в разделе Параметры Visual Studio.

Это пошаговое руководство было написано с использованием параметров разработки Visual C#.

Обязательные компоненты

Необходимо выполнить следующие требования.

  • Для хранения файлов используется выделенная папка ("c:\linqtest6"). Прежде чем приступить к выполнению задач, создайте такую папку.

  • Наличие учебной базы данных Northwind.

    Если база данных не установлена на компьютере разработчика, загрузите ее с веб-узла Центра загрузки Майкрософт. Инструкции см. в разделе Загрузка образцов баз данных (LINQ to SQL). После загрузки базы данных скопируйте файл northwnd.mdf в папку c:\linqtest6.

  • Наличие файла кода C#, созданного из базы данных Northwind.

    Его можно создать либо помощью оператора Реляционный конструктор объектов, либо с помощью средства SQLMetal. Данное пошаговое руководство было написано с использованием средства SQLMetal со следующей командной строкой:

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

    Дополнительные сведения см. в разделе SqlMetal.exe (средство создания кода).

Общие сведения

Данное пошаговое руководство состоит из шести основных задач.

  • Создание решения LINQ to SQL в Visual Studio.

  • Добавление файла кода базы данных в проект.

  • Создание нового объекта клиента.

  • Изменение контактного имени клиента.

  • Удаление заказа.

  • Отправка внесенных изменений в базу данных 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 в проект

При выполнении этих действий подразумевается, что для создания файла кода из учебной базы данных Northwind использовалось средство SQLMetal. Дополнительные сведения см. в разделе "Предварительные требования" ранее в этом руководстве.

Добавление файла кода northwind в проект

  1. В меню Проект выберите команду Добавить существующий элемент.

  2. В диалоговом окне Добавление существующего элемента перейдите к файлу c:\linqtest6\northwind.cs и нажмите кнопку Добавить.

    Файл northwind.cs будет добавлен в проект.

Настройка подключения к базе данных

Сначала проверьте подключение к базе данных. Обратите особое внимание, что в имени базы данных — Northwnd — отсутствует буква "i". Если при выполнении следующих действий возникают ошибки, просмотрите файл northwind.cs, чтобы определить написание разделяемого класса Northwind.

Настройка и проверка подключения к базе данных

  1. Введите или вставьте следующий код в метод Main в классе Program.

    // 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.

    Откроется окно Консоль.

    Чтобы закрыть приложение, в окне Консоль нажмите клавишу ВВОД либо в 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. Чтобы остановить отладку и продолжить выполнение других действий, в окне Консоль нажмите клавишу ВВОД.

Обновление сущности

При выполнении следующих действий будет извлечен объект 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";

Удаление сущности

Используя тот же самый объект клиента, можно удалить первый заказ.

В следующем коде показано, как разорвать связь между строками и удалить строку из базы данных. Чтобы удаление объектов, добавьте следующий код перед 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. Чтобы закрыть приложение, в окне Консоль нажмите клавишу ВВОД.

ПримечаниеПримечание

После добавления нового клиента путем отправки изменений это решение нельзя повторно выполнить в исходном виде.Для повторного выполнения решения измените имя клиента и значение идентификатора добавляемого клиента.

См. также

Основные понятия

Обучение с помощью пошаговых руководств (LINQ to SQL)