DbBatch Класс

Ссылка

Определение

Пространство имен:: System.Data.Common

Сборка:: System.Data.Common.dll

Исходный код:: DbBatch.cs

Исходный код:: DbBatch.cs

Исходный код:: 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)

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

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

Поделиться через