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


DbCommand Класс

Определение

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

public ref class DbCommand abstract : IDisposable
public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, System::Data::IDbCommand
public abstract class DbCommand : IDisposable
public abstract class DbCommand : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbCommand
public abstract class DbCommand : IDisposable, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, IDisposable, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, IAsyncDisposable, System.Data.IDbCommand
type DbCommand = class
    interface IDisposable
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
    interface IAsyncDisposable
type DbCommand = class
    interface IDbCommand
    interface IDisposable
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
Public MustInherit Class DbCommand
Implements IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand, IDisposable
Public MustInherit Class DbCommand
Implements IDbCommand, IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand, IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand
Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand
Наследование
DbCommand
Наследование
Производный
Реализации

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

DbCommand()

Создает экземпляр объекта DbCommand.

Свойства

CanRaiseEvents

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

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

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

CommandTimeout

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

CommandType

Возвращает или задает способ интерпретации свойства CommandText.

Connection

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

Container

Возвращает IContainer, содержащую Component.

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

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

DbParameterCollection

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

DbTransaction

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

DesignMode

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

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

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

Events

Возвращает список обработчиков событий, подключенных к этой Component.

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

Возвращает коллекцию объектов DbParameter. Дополнительные сведения о параметрах см. в настройке параметров и типов данных параметров.

Site

Возвращает или задает ISiteComponent.

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

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

UpdatedRowSource

Возвращает или задает способ применения результатов команды к DataRow при использовании методом Update DbDataAdapter.

Методы

Cancel()

Пытается отменить выполнение DbCommand.

CreateDbParameter()

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

CreateObjRef(Type)

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

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

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

Dispose()

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

Dispose()

Освобождает все ресурсы, используемые Component.

(Унаследовано от Component)
Dispose(Boolean)

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

Dispose(Boolean)

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

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

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

Equals(Object)

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

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

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

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

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

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

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

ExecuteNonQuery()

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

ExecuteNonQueryAsync()

Асинхронная версия ExecuteNonQuery(), которая выполняет команду в объекте подключения, возвращая количество затронутых строк.

Вызывает ExecuteNonQueryAsync(CancellationToken) с помощью CancellationToken.None.

ExecuteNonQueryAsync(CancellationToken)

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

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

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

ExecuteReader()

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

ExecuteReader(CommandBehavior)

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

ExecuteReaderAsync()

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

Вызывает ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) с помощью CancellationToken.None.

ExecuteReaderAsync(CancellationToken)

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

Вызывает ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior)

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

Вызывает ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Вызывает ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteScalar()

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

ExecuteScalarAsync()

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

Вызывает ExecuteScalarAsync(CancellationToken) с помощью CancellationToken.None.

ExecuteScalarAsync(CancellationToken)

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

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

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

GetHashCode()

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

(Унаследовано от Object)
GetLifetimeService()
Устаревшие..

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

(Унаследовано от MarshalByRefObject)
GetService(Type)

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

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

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

(Унаследовано от Object)
InitializeLifetimeService()
Устаревшие..

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

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

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

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

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

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

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

PrepareAsync(CancellationToken)

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

ToString()

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

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

Возвращает String, содержащую имя Component, если таковой имеется. Этот метод не должен быть переопределен.

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

События

Disposed

Происходит при удалении компонента вызовом метода Dispose().

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

Явные реализации интерфейса

IDbCommand.Connection

Возвращает или задает IDbConnection, используемый этим экземпляром IDbCommand.

IDbCommand.CreateParameter()

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

IDbCommand.ExecuteReader()

Выполняет CommandText для Connection и создает IDataReader.

IDbCommand.ExecuteReader(CommandBehavior)

Выполняет CommandText в Connectionи создает IDataReader с помощью одного из значений CommandBehavior.

IDbCommand.Parameters

Возвращает IDataParameterCollection.

IDbCommand.Transaction

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

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

ConfigureAwait(IAsyncDisposable, Boolean)

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

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

См. также раздел

  • обзора ADO.NET