DataContext Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет основную точку входа для платформы LINQ to SQL.
public ref class DataContext : IDisposable
public class DataContext : IDisposable
type DataContext = class
interface IDisposable
Public Class DataContext
Implements IDisposable
- Наследование
-
DataContext
- Реализации
Комментарии
Источник DataContext всех сущностей, сопоставленных с подключением к базе данных. Он отслеживает изменения, внесенные во все извлеченные сущности, и поддерживает "кэш удостоверений", который гарантирует, что сущности, полученные несколько раз, представлены с помощью одного экземпляра объекта.
Как правило, DataContext экземпляр предназначен для последней единицы работы, однако приложение определяет этот термин. Легкое DataContext и не дорогое для создания. Обычное приложение LINQ to SQL создает DataContext экземпляры в области метода или в качестве члена кратковременных классов, представляющих логический набор связанных операций базы данных.
Конструкторы
| Имя | Описание |
|---|---|
| DataContext(IDbConnection, MappingSource) |
Инициализирует новый экземпляр DataContext класса, ссылаясь на подключение и источник сопоставления. |
| DataContext(IDbConnection) |
Инициализирует новый экземпляр класса DataContext путем ссылки на подключение, используемое платформой .NET Framework. |
| DataContext(String, MappingSource) |
Инициализирует новый экземпляр DataContext класса, ссылаясь на источник файла и источник сопоставления. |
| DataContext(String) |
Инициализирует новый экземпляр DataContext класса, ссылаясь на источник файла. |
Свойства
| Имя | Описание |
|---|---|
| ChangeConflicts |
Возвращает коллекцию объектов, вызвавших конфликты SubmitChanges() параллелизма. |
| CommandTimeout |
Возвращает или задает значение, которое увеличивает период времени ожидания (в секундах) для запросов, которые в противном случае истекли бы в течение периода времени ожидания по умолчанию. |
| Connection |
Возвращает соединение, используемое платформой. |
| DeferredLoadingEnabled |
Возвращает или задает значение, указывающее, следует ли загружать связи "один ко многим" или "один к одному". |
| LoadOptions |
Возвращает или задает связанный DataLoadOptions с ним DataContextобъект. |
| Log |
Возвращает или задает назначение для записи SQL-запроса или команды. |
| Mapping |
Возвращает значение, MetaModel на котором основано сопоставление. |
| ObjectTrackingEnabled |
Возвращает или задает значение, указывающее, включена ли отслеживание объектов. |
| Transaction |
Возвращает или задает локальную транзакцию для платформы .NET, используемой для доступа к базе данных. |
Методы
| Имя | Описание |
|---|---|
| CreateDatabase() |
Создает базу данных на сервере. |
| CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[]) |
Выполняет функцию базы данных с табличным значением, связанную с указанным методом .NET. |
| DatabaseExists() |
Определяет, можно ли открыть связанную базу данных. |
| DeleteDatabase() |
Удаляет связанную базу данных. |
| Dispose() |
Освобождает все ресурсы, используемые текущим экземпляром класса DataContext. |
| Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые классом DataContext , и при необходимости освобождает управляемый ресурс. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| ExecuteCommand(String, Object[]) |
Выполняет команды SQL непосредственно в базе данных. |
| ExecuteDynamicDelete(Object) |
Выполняет методы переопределения в LINQ to SQL внутри метода переопределения, чтобы выполнить задачу создания и выполнения динамических операций SQL для удаления. |
| ExecuteDynamicInsert(Object) |
Выполняется внутри методов переопределения вставки, чтобы переопределить LINQ to SQL задачу создания и выполнения динамических операций SQL для операций вставки. |
| ExecuteDynamicUpdate(Object) |
Выполняется внутри методов переопределения обновления, чтобы переопределить LINQ to SQL задачу создания и выполнения динамических операций SQL для операций обновления. |
| ExecuteMethodCall(Object, MethodInfo, Object[]) |
Выполняет хранимую процедуру базы данных или скалярную функцию, связанную с указанным методом .NET. |
| ExecuteQuery(Type, String, Object[]) |
Выполняет запросы SQL непосредственно в базе данных. |
| ExecuteQuery<TResult>(String, Object[]) |
Выполняет SQL-запросы непосредственно в базе данных и возвращает объекты. |
| GetChangeSet() |
Возвращает измененные объекты, отслеживаемые DataContext. |
| GetCommand(IQueryable) |
Возвращает сведения о командах SQL, созданных LINQ to SQL. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetTable(Type) |
Возвращает коллекцию объектов определенного типа, где тип определяется параметром |
| GetTable<TEntity>() |
Возвращает коллекцию объектов определенного типа, где тип определяется параметром |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| Refresh(RefreshMode, IEnumerable) |
Обновляет коллекцию объектов сущностей в соответствии с указанным режимом. |
| Refresh(RefreshMode, Object) |
Обновляет объект сущности в соответствии с указанным режимом. |
| Refresh(RefreshMode, Object[]) |
Обновляет массив объектов сущностей в соответствии с указанным режимом. |
| SubmitChanges() |
Вычисляет набор измененных объектов, которые необходимо вставить, обновить или удалить, и выполняет соответствующие команды для реализации изменений в базе данных. |
| SubmitChanges(ConflictMode) |
Отправляет изменения, внесенные в извлекаемые объекты в базовую базу данных, и указывает действие, которое необходимо предпринять, если отправка завершается ошибкой. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| Translate(DbDataReader) |
Преобразует существующий DbDataReader объект в объекты. |
| Translate(Type, DbDataReader) |
Преобразует существующий DbDataReader объект в объекты. |
| Translate<TResult>(DbDataReader) |
Преобразует существующий DbDataReader объект в объекты. |