DataCommand - класс

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

Иерархия наследования

System.Object
  Microsoft.VisualStudio.Data.Framework.DataSiteableObject<IVsDataConnection>
    Microsoft.VisualStudio.Data.Framework.DataCommand

Пространство имен:  Microsoft.VisualStudio.Data.Framework
Сборка:  Microsoft.VisualStudio.Data.Framework (в Microsoft.VisualStudio.Data.Framework.dll)

Синтаксис

'Декларация
Public MustInherit Class DataCommand _
    Inherits DataSiteableObject(Of IVsDataConnection) _
    Implements IVsDataCommand

public abstract class DataCommand : DataSiteableObject<IVsDataConnection>, 
    IVsDataCommand

public ref class DataCommand abstract : public DataSiteableObject<IVsDataConnection^>, 
    IVsDataCommand

[<AbstractClass>]
type DataCommand =  
    class
        inherit DataSiteableObject<IVsDataConnection>
        interface IVsDataCommand
    end

public abstract class DataCommand extends DataSiteableObject<IVsDataConnection> implements IVsDataCommand

Тип DataCommand предоставляет следующие члены.

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

	Имя	Описание
	DataCommand()	Инициализирует новый экземпляр класса DataCommand.
	DataCommand(IVsDataConnection)	Инициализирует новый экземпляр класса DataCommand вместе с объектом подключения к данным.

В начало страницы

Свойства

	Имя	Описание
	Site	Возвращает или задает сайт объекта. (Унаследовано от DataSiteableObject<T>.)

В начало страницы

Методы

	Имя	Описание
	CreateParameter	Создает объект параметров, который может быть передан в DeriveSchema, DeriveSchema, Execute или методы ExecuteWithoutResults на экземпляре DataCommand.
	DeriveParameters(String)	Выводит параметры, которые можно задать для данной команды.
	DeriveParameters(String, DataCommandType)	Выводит параметры, которые можно задать для данной команды.
	DeriveParameters(String, DataCommandType, Int32)	Выводит параметры, которые можно задать для данной команды.
	DeriveSchema(String)	Выводит схему, возвращаемую из заданной команды.Схемы показана структура элементов и блоков в модуле чтения данных.
	DeriveSchema(String, DataCommandType)	Выводит схему, возвращаемую из заданной команды.Схемы показана структура элементов и блоков в модуле чтения данных.
	DeriveSchema(String, DataCommandType, array<IVsDataParameter[])	Выводит схему, возвращаемую из заданной команды.Схемы показана структура элементов и блоков в модуле чтения данных.
	DeriveSchema(String, DataCommandType, array<IVsDataParameter[], Int32)	Выводит схему, возвращаемую из заданной команды.Схемы показана структура элементов и блоков в модуле чтения данных.
	Equals	Определяет, равен ли заданный объект текущему объекту. (Унаследовано от Object.)
	Execute(String)	Выполняет указанную команду и возвращает только для чтения результатов.
	Execute(String, DataCommandType)	Выполняет указанную команду и возвращает только для чтения результатов.
	Execute(String, DataCommandType, array<IVsDataParameter[])	Выполняет указанную команду, при необходимости с параметрами, и результаты возвращений только для чтения.
	Execute(String, DataCommandType, array<IVsDataParameter[], Int32)	Выполняет указанную команду, при необходимости с параметрами, и результаты возвращений только для чтения.
	ExecuteWithoutResults(String)	Выполняет команду, но не запрашивает результаты, вместо возвращения целое число, показывающее результат вызова.
	ExecuteWithoutResults(String, DataCommandType)	Выполняет команду, но не запрашивает результаты, вместо возвращения целое число, показывающее результат вызова.
	ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[])	Выполняет команду, при необходимости с параметрами, но не запрашивает результаты, вместо возвращения целое число, показывающее результат вызова.
	ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[], Int32)	Выполняет команду, при необходимости с параметрами, но не запрашивает результаты, вместо возвращения целое число, показывающее результат вызова.
	Finalize	Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора. (Унаследовано от Object.)
	GetHashCode	Играет роль хэш-функции для определенного типа. (Унаследовано от Object.)
	GetType	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object.)
	MemberwiseClone	Создает неполную копию текущего объекта Object. (Унаследовано от Object.)
	OnSiteChanged	Создает событие SiteChanged. (Унаследовано от DataSiteableObject<T>.)
	Prepare(String)	Подготавливает указанную команду в источнике данных должно быть выполнено; команда может затем выполнить несколько раз с различными параметрами.
	Prepare(String, DataCommandType)	Подготавливает указанную команду в источнике данных должно быть выполнено; команда может затем выполнить несколько раз с различными параметрами.
	Prepare(String, DataCommandType, array<IVsDataParameter[])	Подготавливает указанную команду в источнике данных должно быть выполнено; команда может затем выполнить несколько раз с различными параметрами.
	Prepare(String, DataCommandType, array<IVsDataParameter[], Int32)	Подготавливает указанную команду в источнике данных должно быть выполнено; команда может затем выполнить несколько раз с различными параметрами.
	ToString	Возвращает строку, которая представляет текущий объект. (Унаследовано от Object.)

В начало страницы

События

	Имя	Описание
	SiteChanged	Происходит при изменении свойства Site. (Унаследовано от DataSiteableObject<T>.)

В начало страницы

Заметки

Поставщики расширяемости конструктора данных (DDEX) могут выполнять различные типы команд в источнике данных.Это не может включать, только быть ограничено, инструкция SQL, процедуры и вызовы функций.Они также могут предоставлять возможность подготовить и наследовать параметры и схемы для команд.

Класс DataCommand описывает типы команд.Тип команды показан программный интерпретация данной командной строки.Например, текст типа команды может уведомить поставщик DDEX, что командная строка инструкция SQL, которое должно быть исполнено напрямую.Кроме того, тип команды TabularFunction может уведомить поставщик DDEX, что в командную строку имя функции с табличным значением, которая должна быть исполнена с помощью соответствующего метода.

Основные технологии, как ODBC (ODBC), OLE DB и повторите ADO.NET перечисления набора разрешенных типов команд, как правило в виде обычного текста, в форме таблицы или хранимые процедуры.Класс DataCommand расширяет это понятие, ослаблять требование, такой тип команды возникает в фиксированном перечислении.Это обеспечивает гибкость, позволяя поставщики DDEX, чтобы добавить пользовательские типы команд вместе с описаниями, как и когда команды может использоваться.

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

Примечания для наследующих объектов

При наследовании от класса DataCommand необходимо переопределить методы из этого класса, который должен быть поддерживаемым ее реализации поставщика DDEX.Базовая реализация каждого метода в этом классе создает NotSupportedException.

Обратите внимание, что метод ExecuteWithoutResults содержит базовую реализацию, делегаты методу Execute.

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.

См. также

Ссылки

Microsoft.VisualStudio.Data.Framework - пространство имен

DataCommandType