Пошаговое руководство. Обработка данных (C#) (LINQ to SQL)
Обновлен: November 2007
В данном руководстве представлен основной и полный сценарий LINQ to SQL по добавлению, изменению и удалению данных в базе данных. Для добавления клиента, изменения его имени и удаления заказа следует использовать копию учебной базы данных Northwind.
.gif "Примечание") Примечание. |
|---|
На вашем компьютере названия некоторых элементов интерфейса пользователя 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
В меню Файл среды Visual Studio укажите пункт Создать и выберите команду Проект.
В диалоговом окне Создание проекта в области Тип проекта выберите Visual C#.
В области Шаблоны щелкните Консольное приложение.
В поле Имя введите LinqDataManipulationApp.
В поле Расположение выберите папку для сохранения файлов проекта.
Нажмите кнопку ОК.
Добавление ссылок и директив LINQ
В этом пошаговом руководстве используются сборки, которые могут быть не установлены по умолчанию в проект. Если System.Data.Linq не входит в список ссылок проекта, добавьте ее, как описано в следующих действиях.
Добавление сборки System.Data.Linq
В Обозревателе решений щелкните правой кнопкой мыши узел Ссылки и выберите команду Добавить ссылку.
В диалоговом окне Добавление ссылки щелкните .NET, выберите сборку System.Data.Linq, а затем нажмите кнопку ОК.
Сборка будет добавлена в проект.
Добавьте следующие директивы в начало Program.cs.
using System.Data.Linq; using System.Data.Linq.Mapping;
Добавление файла кода Northwind в проект
При выполнении этих действий подразумевается, что для создания файла кода из учебной базы данных Northwind использовалось средство SQLMetal. Дополнительные сведения см. в разделе "Предварительные требования" ранее в этом руководстве.
Добавление файла кода northwind в проект
В меню Проект выберите команду Добавить существующий элемент.
В диалоговом окне Добавление существующего элемента перейдите к файлу c:\linqtest6\northwind.cs и нажмите кнопку Добавить.
Файл northwind.cs будет добавлен в проект.
Настройка подключения к базе данных
Сначала проверьте подключение к базе данных. Обратите особое внимание, что в имени базы данных — Northwnd — отсутствует буква "i". Если при выполнении следующих действий возникают ошибки, просмотрите файл northwind.cs, чтобы определить написание разделяемого класса Northwind.
Настройка и проверка подключения к базе данных
Введите или вставьте следующий код в метод 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();Чтобы проверить приложение на этом этапе, нажмите клавишу F5.
Откроется окно Консоль.
Чтобы закрыть приложение, в окне Консоль нажмите клавишу ВВОД либо в Visual Studio в меню Отладка выберите команду Остановить отладку.
Создание новой сущности
Создание новой сущности не представляет особых проблем. Для создания объектов (например, Customer) можно использовать ключевое слово new.
В этом и следующих разделах выполняются изменения только локального кэша. Изменения не будут отправлены в базу данных до тех пор, пока ближе к концу данного руководства не будет вызван SubmitChanges.
Добавление нового объекта сущностей Customer
Создайте новый 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); }Нажмите клавишу F5 для отладки решения.
Чтобы остановить отладку и продолжить выполнение других действий, в окне Консоль нажмите клавишу ВВОД.
Обновление сущности
При выполнении следующих действий будет извлечен объект 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);
Отправка изменений в базу данных
Последнее действие, необходимое для создания, обновления и удаления объектов, заключается в фактической отправке изменений в базу данных. Без него изменения останутся на локальном уровне и не появятся в результатах запроса.
Отправка изменений в базу данных
Вставьте следующий код перед Console.ReadLine.
db.SubmitChanges();Вставьте следующий код (после 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); }Нажмите клавишу F5 для отладки решения.
Чтобы закрыть приложение, в окне Консоль нажмите клавишу ВВОД.
| Примечание. |
|---|
После добавления нового клиента путем отправки изменений это решение нельзя повторно выполнить в исходном виде. Для повторного выполнения решения измените имя клиента и значение идентификатора добавляемого клиента. |