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)

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

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