DbCommand Класс

Определение

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

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

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

Сборка:: netstandard.dll

Важно!

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

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

public ref class DbCommand abstract : IDisposable

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, 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

type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbCommand
Implements 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

Наследование: Object
DbCommand

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

MarshalByRefObject

Component
DbCommand

Производный: System.Data.EntityClient.EntityCommand

System.Data.Odbc.OdbcCommand

System.Data.OleDb.OleDbCommand

System.Data.OracleClient.OracleCommand

System.Data.SqlClient.SqlCommand

Реализации: IDisposable IDbCommand IAsyncDisposable

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

Имя	Описание
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	Возвращает или задает ISite объект Component. (Унаследовано от 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, CancellationToken)	ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Вызывается.
ExecuteReaderAsync(CommandBehavior)	Асинхронная версия ExecuteReader, которая выполняет команду с его подключением, возвращая DbDataReader объект, который можно использовать для доступа к результатам. 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

Обратная связь

Были ли сведения на этой странице полезными?