DbBatch Класс

Определение

Пространство имен:

System.Data.Common

Сборка:

System.Data.Common.dll

Исходный код:

DbBatch.cs

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

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

Наследование

Object

DbBatch

Реализации

IAsyncDisposable IDisposable

Комментарии

Точная семантика пакетного выполнения зависит от поставщиков 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)

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