DataContext Класс

Определение

Представляет основную точку входа для платформы LINQ to SQL.Represents the main entry point for the LINQ to SQL framework.

public ref class DataContext : IDisposable
public class DataContext : IDisposable
type DataContext = class
    interface IDisposable
Public Class DataContext
Implements IDisposable
Наследование
DataContext
Реализации

Комментарии

DataContext — Это источник всех сущностей, сопоставленных с подключением к базе данных.The DataContext is the source of all entities mapped over a database connection. Он отслеживает изменения, внесенные во все извлеченные сущности, и поддерживает "кэш идентификаторов", гарантирующий, что сущности, полученные более одного раза, представляются с помощью одного и того же экземпляра объекта.It tracks changes that you made to all retrieved entities and maintains an "identity cache" that guarantees that entities retrieved more than one time are represented by using the same object instance.

Как DataContext правило, экземпляр предназначен для последней "единицы работы", однако приложение определяет этот термин.In general, a DataContext instance is designed to last for one "unit of work" however your application defines that term. Объект DataContext является простым и не может быть затратным для создания.A DataContext is lightweight and is not expensive to create. Типичное LINQ to SQLLINQ to SQL приложение создает DataContext экземпляры в области действия метода или в качестве члена кратковременных классов, представляющих логический набор связанных операций с базами данных.A typical LINQ to SQLLINQ to SQL application creates DataContext instances at method scope or as a member of short-lived classes that represent a logical set of related database operations.

Конструкторы

DataContext(IDbConnection)

Инициализирует новый экземпляр класса DataContext, ссылаясь на подключение, используемое .NET Framework.NET Framework.Initializes a new instance of the DataContext class by referencing the connection used by the .NET Framework.NET Framework.

DataContext(IDbConnection, MappingSource)

Инициализирует новый экземпляр класса DataContext, ссылаясь на подключение и источник сопоставления.Initializes a new instance of the DataContext class by referencing a connection and a mapping source.

DataContext(String)

Инициализирует новый экземпляр класса DataContext, ссылаясь на источник файла.Initializes a new instance of the DataContext class by referencing a file source.

DataContext(String, MappingSource)

Инициализирует новый экземпляр класса DataContext, ссылаясь на источник файлов и источник сопоставления.Initializes a new instance of the DataContext class by referencing a file source and a mapping source.

Свойства

ChangeConflicts

Возвращает коллекцию объектов, ставшую причиной конфликта параллелизма, когда был вызван метод SubmitChanges().Gets a collection of objects that caused concurrency conflicts when SubmitChanges() was called.

CommandTimeout

Возвращает или задает значение, которое увеличивает время ожидания для запросов (в секундах), для которых в противном случае время ожидания истекло бы в течение времени ожидания по умолчанию.Gets or sets a value that increases the time-out period (in seconds) for queries that would otherwise time out during the default time-out period.

Connection

Возвращает подключение, используемое платформой.Gets the connection used by the framework.

DeferredLoadingEnabled

Возвращает или задает значение, указывающее, следует ли загружать с задержкой связи "один к одному" или "один ко многим".Gets or sets a value that indicates whether to delay-load one-to-many or one-to-one relationships.

LoadOptions

Возвращает или задает объект DataLoadOptions, связанный с данным объектом DataContext.Gets or sets the DataLoadOptions associated with this DataContext.

Log

Возвращает или задает назначение для записи команды или запроса SQL.Gets or sets the destination to write the SQL query or command.

Mapping

Возвращает MetaModel, на котором основано сопоставление.Gets the MetaModel on which the mapping is based.

ObjectTrackingEnabled

Возвращает или задает значение, указывающее, включено ли отслеживание объекта.Gets or sets a value that indicates whether object tracking is enabled.

QueryCacheEnabled
Transaction

Возвращает или задает локальную транзакцию для использования .NET Framework.NET Framework для доступа к базе данных.Gets or sets a local transaction for the .NET Framework.NET Framework to use to access the database.

Методы

CreateDatabase()

Создает базу данных на сервере.Creates a database on the server.

CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[])

Выполняет табличную функцию базы данных, связанную с указанным методом .NET.Executes the table-valued database function associated with the specified .NET method.

DatabaseExists()

Определяет, можно ли открыть связанную базу данных.Determines whether the associated database can be opened.

DeleteDatabase()

Удаляет связанную базу данных.Deletes the associated database.

Dispose()

Освобождает все ресурсы, используемые текущим экземпляром класса DataContext.Releases all resources used by the current instance of the DataContext class.

Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые классом DataContext (при необходимости освобождает и управляемые ресурсы).Releases the unmanaged resources used by the DataContext class and optionally releases the managed resource.

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
ExecuteCommand(String, Object[])

Выполняет команды SQL непосредственно в базе данных.Executes SQL commands directly on the database.

ExecuteDynamicDelete(Object)

Выполняет внутренние методы переопределения удаления для повторного делегирования в LINQ to SQLLINQ to SQL задачи создания и выполнения динамического SQL для операций удаления.Executes, inside delete override methods, to redelegate to LINQ to SQLLINQ to SQL the task of generating and executing dynamic SQL for delete operations.

ExecuteDynamicInsert(Object)

Выполняет внутренние методы переопределения вставки для повторного делегирования в LINQ to SQLLINQ to SQL задачи создания и выполнения динамического SQL для операций вставки.Executes, inside insert override methods, to redelegate to LINQ to SQLLINQ to SQL the task of generating and executing dynamic SQL for insert operations.

ExecuteDynamicUpdate(Object)

Выполняет внутренние методы переопределения обновления для повторного делегирования в LINQ to SQLLINQ to SQL задачи создания и выполнения динамического SQL для операций обновления.Executes, inside update override methods, to redelegate to LINQ to SQLLINQ to SQL the task of generating and executing dynamic SQL for update operations.

ExecuteMethodCall(Object, MethodInfo, Object[])

Выполняет хранимую процедуру базы данных или скалярную функцию, связанную с указанным методом .NET.Executes the stored database procedure or scalar function associated with the specified .NET method.

ExecuteQuery(Type, String, Object[])

Выполняет SQL-запросы непосредственно в базе данных.Executes SQL queries directly on the database.

ExecuteQuery<TResult>(String, Object[])

Выполняет запросы SQL непосредственно в базе данных и возвращает объекты.Executes SQL queries directly on the database and returns objects.

GetChangeSet()

Возвращает измененные объекты, отслеживаемые DataContext.Gets the modified objects tracked by DataContext.

GetCommand(IQueryable)

Возвращает сведения о командах SQL, созданных LINQ to SQLLINQ to SQL.Gets the information about SQL commands generated by LINQ to SQLLINQ to SQL.

GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetIDbCommand(IQueryable)
GetTable(Type)

Возвращает коллекцию объектов определенного типа, где тип определяется параметром type.Returns a collection of objects of a particular type, where the type is defined by the type parameter.

GetTable<TEntity>()

Возвращает коллекцию объектов определенного типа, где тип определяется параметром TEntity.Returns a collection of objects of a particular type, where the type is defined by the TEntity parameter.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
Refresh(RefreshMode, IEnumerable)

Обновляет коллекцию объектов сущности согласно указанному режиму.Refreshes a collection of entity objects according to the specified mode.

Refresh(RefreshMode, Object)

Обновляет объект сущности согласно указанному режиму.Refreshes an entity object according to the specified mode.

Refresh(RefreshMode, Object[])

Обновляет массив объектов сущности согласно указанному режиму.Refreshes an array of entity objects according to the specified mode.

SubmitChanges()

Вычисляет набор измененных объектов, которые следует вставить, обновить или удалить, и выполняет соответствующие команды для внесения изменений в базу данных.Computes the set of modified objects to be inserted, updated, or deleted, and executes the appropriate commands to implement the changes to the database.

SubmitChanges(ConflictMode)

Отправляет изменения, которые были внесены в извлеченные объекты для основной базы данных, и указывает действие, которое следует выполнить, если не удастся осуществить передачу.Sends changes that were made to retrieved objects to the underlying database, and specifies the action to be taken if the submission fails.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
Translate(DbDataReader)

Преобразовывает существующий DbDataReader в объекты.Converts an existing DbDataReader to objects.

Translate(Type, DbDataReader)

Преобразовывает существующий DbDataReader в объекты.Converts an existing DbDataReader to objects.

Translate<TResult>(DbDataReader)

Преобразовывает существующий DbDataReader в объекты.Converts an existing DbDataReader to objects.

Применяется к