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)	Настраивает способ ожидания задач, возвращаемых из асинхронного удаления.