DataCommand.Prepare - метод (String, DataCommandType, array<IVsDataParameter )

Статья
11/01/2012

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

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

Синтаксис

'Декларация
Public Function Prepare ( _
    command As String, _
    commandType As DataCommandType, _
    parameters As IVsDataParameter() _
) As String

public string Prepare(
    string command,
    DataCommandType commandType,
    IVsDataParameter[] parameters
)

public:
virtual String^ Prepare(
    String^ command, 
    DataCommandType commandType, 
    array<IVsDataParameter^>^ parameters
) sealed

abstract Prepare : 
        command:string * 
        commandType:DataCommandType * 
        parameters:IVsDataParameter[] -> string 
override Prepare : 
        command:string * 
        commandType:DataCommandType * 
        parameters:IVsDataParameter[] -> string

public final function Prepare(
    command : String, 
    commandType : DataCommandType, 
    parameters : IVsDataParameter[]
) : String

Параметры

command
Тип: System.String
Выполнять команды, определяемые источником данных.

commandType
Тип: Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType
Тип команды, которая определяет, как интерпретировать содержимое параметра command.Тип команды может быть либо значением из перечисления DataCommandType или пользовательским типом команды указанного поставщиком, который может быть передан в путем принудительной приведение от целого числа в перечисление DataCommandType.

parameters
Тип: array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]
Массив объектов IVsDataParameter, представляющий параметры команд для заданной команды.

Возвращаемое значение

Тип: System.String
Идентификатор подготовленной команды, которую в дальнейшем могут передаваться Execute или методу ExecuteWithoutResults с помощью типа Prepared команды.

Реализации

IVsDataCommand.Prepare(String, DataCommandType, array<IVsDataParameter[])

Исключения

Исключение	Условие
ArgumentNullException	Значение параметра command — nullссылка NULL (Nothing в Visual Basic).
ArgumentOutOfRangeException	Значение параметра commandTimeout меньше -1.

Заметки

Другие исключения, происходящие указывают, что подготовка для поставщик- указанной причине.

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.