Нашли ошибку или опечатку? Выделите текст и нажмите

Поменять цветовую

гамму сайта?

Поменять
Обновления сайта
и новые разделы

Рекомендовать в Google +1

Класс ObjectContext

28

»» В ДАННОЙ СТАТЬЕ ИСПОЛЬЗУЕТСЯ ИСХОДНЫЙ КОД ДЛЯ ПРИМЕРОВ

Класс ObjectContext лежит в основе платформы Entity Framework и LINQ to Entities. Когда создается сущностная модель данных, то создается класс, производный от ObjectContext, со свойствами, представляющими сущностные типы и коллекции, специфичные для базы данных.

В сущностной модели данных Northwind, такой производный класс назывался NorthwindEntities. Этот класс использовался во всех примерах LINQ to Entities для обработки соединения с базой данных, загрузки сущностных объектов и сохранения изменений после выполнения модификаций. И, поскольку он производный, класс NorthwindEntities имеет общедоступные члены — коллекции сущностных объектов, представляющих содержимое базы данных Northwind.

Класс ObjectContext определен в пространстве имен System.Data.Objects.

Прежде чем можно будет использовать какие-либо средства Entity Framework или LINQ to Entities, описанные в предыдущих статьях, потребуется создать новый экземпляр производного класса ObjectContext. Созданный экземпляр отвечает за управление соединением с базой данных и используется для загрузки и сохранения данных в базе.

Существуют два прототипа конструктора ObjectContext, которые описаны ниже:

Первый унаследованный от ObjectContext конструктор
public NortwindEntities();

Это конструктор по умолчанию, создающий новый экземпляр производного класса ObjectContext с использованием строки подключения к базе данных, которая была добавлена в файл App.Config при создании сущностной модели данных. Это прототип применялся во всех примерах посвященных LINQ to Entities.

Второй унаследованный от ObjectContext конструктор
public NortwindEntities{string connectionString);

Этот прототип конструктора позволяет указать детали, которые будут использованы для подключения к базе данных, либо имя строки подключения из файла App.config.

В следующем коде показано использование обоих прототипов:

// Первый прототип
            NorthwindEntities context = new NorthwindEntities();

            IQueryable<Customer> custs = context.Customers
                                                .Where(c => c.City == "London")
                                                .Select(c => c);

// Второй прототип, на основе класса SqlConnectionStringBuilder
            System.Data.SqlClient.SqlConnectionStringBuilder scsb = 
                new System.Data.SqlClient.SqlConnectionStringBuilder();

            scsb.DataSource = @"MICROSOF-1EA29E\SQLEXPRESS;";
            scsb.InitialCatalog = "Northwind";
            scsb.IntegratedSecurity = true;
            scsb.MultipleActiveResultSets = true;

            context = new NorthwindEntities(scsb.ToString());

ObjectContext.DatabaseExists()

Метод DatabaseExists возвращает true, если база данных, которая указана в строке подключения, использованной для создания ObjectContext, существует и false — в противном случае.

Метод DatabaseExists имеет один прототип, описанный ниже:

public bool DatabaseExists();

В следующем примере создается экземпляр производного от ObjectContext класса для базы данных Northwind и используется метод DatabaseExists:


            NorthwindEntities context = new NorthwindEntities();

            bool databaseExists = context.DatabaseExists();
            Console.WriteLine("\n  База данных {0}", databaseExists ? "существует" : "не существует");
Использование метода DatabaseExists

ObjectContext.CreateDatabase()

Метод CreateDatabase использует сущностную модель данных для создания новой базы данных, хотя, конечно, в ней не будет никаких данных. Этот метод обычно применяется в сочетании с методом DatabaseExists.

Метод CreateDatabase имеет один прототип:

public void CreateDatabase();

В следующем примере создается новая база данных с использованием сущностной модели базы данных Northwind:

NorthwindEntities context = new NorthwindEntities();
                  
if (!context.DatabaseExists()) 
    context.CreateDatabase();

ObjectContext.DeleteDatabase()

Метод DeleteDatabase удаляет базу данных, которая указана в строке соединения, использованной для создания производного от ObjectContext экземпляра. Этот метод обычно применяется в сочетании с методом DatabaseExists.

Метод DeleteDatabase имеет один прототип:

public void DeleteDatabase();

В следующем примере метод DeleteDatabase используется для удаления базы данных Northwind. После компиляции и запуска этого примера понадобится восстановить исходную версию базы данных Northwind:

NorthwindEntities context = new NorthwindEntities();

if (context.DatabaseExists()) 
    context.DeleteDatabase();                  

ObjectContext.SaveChanges()

Метод SaveChanges сохраняет модификации, проведенные в сущностных объектах базы данных. Этот метод генерирует исключение OptomisticConcurencyException если включена проверка параллельного доступа и возникает конфликт обновления.

Метод SaveChanges имеет один прототип, описанный ниже:

public int SaveChanges();

Возвращаемое значение указывает количество добавленных, обновленных или удаленных объектов. В следующем коде модифицируется поле ContactName сущностного типа Customer и вызывается метод SaveChanges() для сохранения модификаций в базе данных:

NorthwindEntities context = new NorthwindEntities();

Customer cust = (from c in context.Customers
                             where c.CustomerID == "LAZYK"
                             select c).First();

cust.ContactName = "John Doe";

int modificationCount = context.SaveChanges();

Console.WriteLine("\n  Количество проведенных модификаций: {0}", modificationCount);
Использование метода SaveChanges

ObjectContext.AddObject()

Метод AddObject добавляет новый сущностный объект к одной из коллекций, поддерживаемой классом-наследником ObjectContext.

У метода AddObject один прототип:

public void AddObject(string entitySetName, Object entity);

Первый аргумент — имя коллекции, в которую объект должен быть добавлен. Второй аргумент — сущностный объект, который вы хотите добавить. Заметьте, что база данных не обновляется данными, содержащимися в новом сущностном объекте, пока не будет вызван метод SaveChanges.

В следующем примере, показанном ниже, создается новый экземпляр сущностного типа Customer, а также устанавливаются значения полей. Метод AddObject используется для добавления сущностного объекта в коллекцию Customers. Наконец, метод SaveChanges применяется для записи новой записи Customer в базу данных:

NorthwindEntities context = new NorthwindEntities();

            // Создать новый объект Customer
            Customer cust = Customer.CreateCustomer("LAWN", "Lawn Wranglers");

            // Заполнить поля, допускающие null
            cust.ContactName = "Mr. Abe Henry";
            cust.ContactTitle = "Owner";
            cust.Address = "1017 Maple Leaf Way";
            cust.City = "Ft. Worth";
            cust.Region = "TX";
            cust.PostalCode = "76104";
            cust.Country = "USA";
            cust.Phone = "(800) MOW-LAWN";
            cust.Fax = "(800) MOW-LAWO";

            context.AddObject("Customers", cust);

            context.SaveChanges();

ObjectContext.CreateObject()

Метод CreateObject создает новый сущностный объект. Новый объект не содержит данных и должен быть добавлен к одной из коллекций сущностных объектов в ObjectContext. Только после этого метод SaveChanges сохранит объект в базе данных. Если определение схемы базы данных требует, чтобы некоторые поля не содержали null, необходимо обеспечить наполнение сущностного объекта перед вызовом SaveChanges.

Метод CreateObject строго типизирован, в том смысле, что для каждого сущностного типа, поддерживаемого классом-наследником ObjectContext, существует один прототип в следующей форме, где T — сущностный тип, экземпляр которого необходимо создать:

public T CreateObject<T>();

В случае базы данных Northwind это означает, что для сущностного типа Customer есть такой прототип:

public Customer CreateObject<Customer>();

Для сущностного типа Order прототип выглядит следующим образом:

public Order CreateObject<Order>();

Прототипы для каждого из сущностных типов, содержащихся в сущностной модели данных, похожи на показанные выше.

В коде, приведенном ниже, метод CreateObject используется для создания нового сущностного объекта Customer. Поля заполняются (включая поля CustomerID и CompanyName, которые не допускают null), и объект добавляется в коллекцию Customers с помощью метода AddObject. Новый Customer сохраняется в базе данных вызовом метода SaveChanges:

NorthwindEntities context = new NorthwindEntities();

            // Создать новый объект Customer
            Customer cust = context.CreateObject<Customer>();

            // Заполнить все поля
            cust.CustomerID = "LAWN";
            cust.CompanyName = "Lawn Wranglers";
            cust.ContactName = "Mr. Abe Henry";
            cust.ContactTitle = "Owner";
            cust.Address = "1017 Maple Leaf Way";
            cust.City = "Ft. Worth";
            cust.Region = "TX";
            cust.PostalCode = "76104";
            cust.Country = "USA";
            cust.Phone = "(800) MOW-LAWN";
            cust.Fax = "(800) MOW-LAWO";

            context.AddObject("Customers", cust);

            context.SaveChanges();

ObjectContext.DeleteObject()

Метод DeleteObject удаляет объект из кэша сущностей и удаляет соответствующий данные из базы при вызове метода SaveChanges. При удалении объектов, у которых есть связанные с ними объекты, следует соблюдать осторожность.

Метод DeleteObject имеет один прототип:

public void DeleteObject(Object entity);

Аргумент в этом прототипе — это сущностный объект, который должен быть удален.

Код из следующего примера запрашивает сущностные объекты OrderDetail, имеющие OrderID, равный 10248. Результаты перечисляются в цикле foreach и удаляются с помощью метода DeleteObject. Чтобы сохранить удаление, вызывается метод SaveChanges:

NorthwindEntities context = new NorthwindEntities();

            // Получить детали заказа 10248
            IQueryable<Order_Detail> ods = (from o in context.Order_Details
                               where o.OrderID == 10248
                               select o);

            foreach (Order_Detail od in ods) {
                context.DeleteObject(od);
            }

            // Сохранить изменения
            context.SaveChanges();
Пройди тесты