Методы DataContext (конструктор O/R)

DataContext Методы (в контексте средств LINQ to SQL в Visual Studio) — это методы DataContext класса, выполняющего хранимые процедуры и функции в базе данных.

Этот DataContext класс — это класс LINQ to SQL, который выступает в качестве канала между базой данных SQL Server и классами сущностей LINQ to SQL, сопоставленными с этой базой данных. Класс DataContext содержит сведения о строке подключения и методы для подключения к базе данных и управления данными в базе данных. По умолчанию DataContext класс содержит несколько методов, которые можно вызвать, например SubmitChanges метод, который отправляет обновленные данные из классов LINQ в SQL в базу данных. Можно также создать дополнительные DataContext методы, которые сопоставляют хранимые процедуры и функции. Другими словами, вызов этих пользовательских методов запускает выполнение хранимой процедуры или функции в базе данных, к которым сопоставлен метод DataContext. Вы можете добавить новые методы в DataContext класс так же, как и методы для расширения любого класса. Однако в обсуждениях о DataContext методах в контексте конструктора O/R речь идет именно о DataContext методах, которые сопоставляются с хранимыми процедурами и функциями.

Панель методов

DataContext Методы, которые сопоставляются с хранимыми процедурами и функциями, отображаются в области «Методы»конструктора O/R. Область "Методы " находится на стороне области "Сущности " (основная область конструктора). В области "Методы " перечислены все DataContext методы, созданные с помощью конструктора O/R. По умолчанию область "Методы " пуста; Перетащите хранимые процедуры или функции из обозревателя серверов или обозревателябаз данных в конструктор O/R , чтобы создать DataContext методы и заполнить область "Методы ". Дополнительные сведения см. в разделе "Практическое руководство. Создание методов DataContext, сопоставленных с хранимыми процедурами и функциями (конструктор операций ввода-вывода)".

Два типа методов DataContext

Методы DataContext — это те методы, которые сопоставляются с хранимыми процедурами и функциями в базе данных. Вы можете создавать и добавлять методы DataContext на панели "Методы " конструктора O/R. Существует два разных типа DataContext методов: те, которые возвращают один или несколько результирующих наборов, и те, которые не выполняют следующие действия:

• DataContext методы, возвращающие один или несколько результирующих наборов:

  Создайте этот DataContext метод, когда приложению нужно выполнять хранимые процедуры и функции в базе данных и возвращать результаты. Дополнительные сведения см. в статье "Как: Создать методы DataContext, сопоставленные с хранимыми процедурами и функциями (конструктор O/R)", System.Data.Linq.ISingleResult<T> и IMultipleResults.

• DataContext методы, не возвращающие результирующие наборы: такие как Inserts, Updates и Deletes для определенного класса сущности.

  Создайте этот DataContext метод, если приложение должно выполнять хранимые процедуры вместо использования поведения LINQ to SQL по умолчанию для сохранения измененных данных между классом сущностей и базой данных. Дополнительные сведения см. в статье "Практическое руководство. Назначение хранимых процедур для выполнения обновлений, вставок и удалений (конструктор операций ввода-вывода)".

Возвращаемые типы методов DataContext

При перетаскивании хранимых процедур и функций из обозревателя серверов или обозревателябаз данных в конструктор O/R возвращаемый тип созданного DataContext метода отличается в зависимости от места удаления элемента. Падение элементов непосредственно на существующий класс сущности создает DataContext метод с возвращаемым типом класса сущности; падение элементов в пустую область конструктора O/R (в любой области) создает DataContext метод, который возвращает автоматически сгенерированный тип. Автоматически созданный тип имеет имя, соответствующее хранимой процедуре или имени функции и свойствам, которые сопоставляются с полями, возвращаемыми хранимой процедурой или функцией.

Объекты, перетаскиваемые из базы данных в область конструктора O/R, автоматически называются на основе имени объектов в базе данных. При перетаскивании одного и того же объекта несколько раз число добавляется в конец нового имени, которое отличает имена. Если имена объектов базы данных содержат пробелы или символы, не поддерживаемые в Visual Basic или C#, пробел или недопустимый символ заменяются подчеркиванием.

Связанный контент

• Инструменты LINQ to SQL в Visual Studio
• LINQ to SQL
• Хранимые процедуры
• Практическое руководство. Создание методов DataContext, сопоставленных с хранимыми процедурами и функциями (конструктор O/R)
• Практическое руководство. Назначение хранимых процедур для выполнения обновлений, вставок и удаления (конструктор операций ввода-вывода)
• Пошаговое руководство. Настройка поведения вставки, обновления и удаления классов сущностей
• Пошаговое руководство. Создание классов LINQ to SQL (конструктор O-R)