DbBatch Класс

Определение

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

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

Комментарии

Точная семантика пакетного выполнения зависит от поставщиков ADO.NET, особенно при обработке ошибок. По возможности рекомендуется немедленно завершить пакет, пропустить все последующие команды и выполнить откат команд, которые уже выполнены. Однако это поведение может не поддерживаться в разных базах данных; Ознакомьтесь с документацией поставщика ADO.NET.

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

DbBatch()

Инициализирует новый экземпляр класса DbBatch.

Свойства

BatchCommands

Возвращает коллекцию объектов DbBatchCommand.

Connection

Возвращает или задает соединение DbConnection, используемое этой командой DbBatch.

DbBatchCommands

При переопределении в производном классе возвращает коллекцию объектов DbBatchCommand.

DbConnection

При переопределении в производном классе получает или задает DbConnection, используемый DbBatch.

DbTransaction

При переопределении в производном классе получает или задает DbTransaction, который выполняет этот объект DbBatch.

Timeout

Возвращает или задает время ожидания (в секундах), прежде чем завершать попытку выполнить пакет и создать ошибку.

Transaction

Возвращает или задает контекст DbTransaction, в котором выполняется этот объект DbBatch.

Методы

Cancel()

Пытается отменить выполнение объекта DbBatch.

CreateBatchCommand()

Создает новый экземпляр объекта DbBatchCommand.

CreateDbBatchCommand()

При переопределении в производном классе создает новый экземпляр объекта DbBatchCommand.

Dispose()

Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.

DisposeAsync()

Асинхронно разлагает пакетный объект.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

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

При переопределении в производном классе выполняет пакет с подключением, возвращая значение DbDataReader , которое можно использовать для доступа к результатам.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Поставщики должны реализовать этот метод, чтобы предоставить реализацию, отличную от реализации по умолчанию, для перегрузок ExecuteReader.

Реализация по умолчанию вызывает синхронный метод ExecuteReader() и возвращает завершенную задачу, блокируя вызывающий поток. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный токен отмены. Исключения, создаваемые ExecuteReader, будут связаны через возвращаемое свойство исключения задачи.

Этот метод принимает токен отмены, который может использоваться для запроса ранней отмены операции. Реализации могут игнорировать данный запрос.

ExecuteNonQuery()

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

ExecuteNonQueryAsync(CancellationToken)

Это асинхронная версия метода ExecuteNonQuery(). Поставщики должны выполнить переопределение с помощью соответствующей реализации. При необходимости можно игнорировать токен отмены.

Реализация по умолчанию вызывает синхронный метод ExecuteNonQuery() и возвращает завершенную задачу, блокируя вызывающий поток. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный токен отмены. Исключения, создаваемые ExecuteNonQuery(), будут связаны через возвращаемое свойство исключения задачи.

Не вызывайте другие методы и свойства объекта DbCommand до тех пор, пока возвращаемая задача не будет завершена.

ExecuteReader(CommandBehavior)

Выполняет пакет для подключения, возвращая его DbDataReader , который можно использовать для доступа к результатам.

ExecuteReaderAsync(CancellationToken)

Асинхронная ExecuteReaderверсия, которая выполняет пакет с его подключением, возвращая значение DbDataReader , которое можно использовать для доступа к результатам.

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Асинхронная ExecuteReaderверсия, которая выполняет пакет с его подключением, возвращая значение DbDataReader , которое можно использовать для доступа к результатам.

ExecuteScalar()

Выполняет пакет и возвращает первый столбец первой строки в первом возвращенном результирующем наборе. Все остальные столбцы, строки и наборы результатов игнорируются.

ExecuteScalarAsync(CancellationToken)

Асинхронная ExecuteScalar()версия, которая выполняет пакет и возвращает первый столбец первой строки в первом возвращенном результирующем наборе. Все остальные столбцы, строки и результирующие наборы игнорируются.

GetHashCode()

Служит хэш-функцией по умолчанию.

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

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

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

Создает неполную копию текущего объекта Object.

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

Создает подготовленную (или скомпилированную) версию пакета или каждой из ее команд в источнике данных.

PrepareAsync(CancellationToken)

Асинхронно создает подготовленную (или скомпилированную) версию пакета или каждую из ее команд в источнике данных.

ToString()

Возвращает строку, представляющую текущий объект.

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

Методы расширения

ConfigureAwait(IAsyncDisposable, Boolean)

Настраивает способ выполнения ожиданий для задач, возвращаемых из асинхронного высвобождаемого объекта.

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