AdoDotNetConnectionSupport.PrepareCore Method

Prepares the specified command on the data source to be executed; the command can be executed multiple times, with varying parameters.

Namespace:  Microsoft.VisualStudio.Data.Framework.AdoDotNet
Assembly:  Microsoft.VisualStudio.Data.Framework (in Microsoft.VisualStudio.Data.Framework.dll)

Syntax

'Declaration
Protected Overridable Function PrepareCore ( _
    command As String, _
    commandType As DataCommandType, _
    parameters As IVsDataParameter(), _
    commandTimeout As Integer _
) As String

protected virtual string PrepareCore(
    string command,
    DataCommandType commandType,
    IVsDataParameter[] parameters,
    int commandTimeout
)

protected:
virtual String^ PrepareCore(
    String^ command, 
    DataCommandType commandType, 
    array<IVsDataParameter^>^ parameters, 
    int commandTimeout
)

abstract PrepareCore : 
        command:string * 
        commandType:DataCommandType * 
        parameters:IVsDataParameter[] * 
        commandTimeout:int -> string  
override PrepareCore : 
        command:string * 
        commandType:DataCommandType * 
        parameters:IVsDataParameter[] * 
        commandTimeout:int -> string

protected function PrepareCore(
    command : String, 
    commandType : DataCommandType, 
    parameters : IVsDataParameter[], 
    commandTimeout : int
) : String

Parameters

• command
  Type: System.String

  Command to prepare for execution.

• commandType
  Type: Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType

  Command type for the indicated command, specifying how to interpret the contents of the command parameters.

• parameters
  Type: array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]

  Array of IVsDataParameter objects for the specified command type.

• commandTimeout
  Type: System.Int32

  Length of time, in seconds, to block the client before canceling the schema derivation and returning to the caller. A value of zero indicates infinite time-out; a value of -1 indicates a provider default.

Return Value

Type: System.String
An identifier of the prepared command that can later be passed to the ExecuteCore or ExecuteWithoutResultsCore method.

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

AdoDotNetConnectionSupport Class

Microsoft.VisualStudio.Data.Framework.AdoDotNet Namespace