DataCommand.Prepare Method

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

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

Syntax

'宣言
Public Overridable Function Prepare ( _
    command As String, _
    commandType As Integer, _
    commandTimeout As Integer _
) As String
'使用
Dim instance As DataCommand
Dim command As String
Dim commandType As Integer
Dim commandTimeout As Integer
Dim returnValue As String

returnValue = instance.Prepare(command, _
    commandType, commandTimeout)

public virtual string Prepare(
    string command,
    int commandType,
    int commandTimeout
)

public:
virtual String^ Prepare(
    String^ command, 
    int commandType, 
    int commandTimeout
)

public function Prepare(
    command : String, 
    commandType : int, 
    commandTimeout : int
) : String

Parameters

command
Type: System.String

A command to execute that is specific to a data source.

commandType
Type: System.Int32

The command type for the indicated command, specifying how to interpret the contents of the command parameter.

commandTimeout
Type: System.Int32

The length of time, in seconds, to block the client before canceling the execution and returning to the caller. A value of 0 indicates infinite timeout; a value of -1 indicates a provider default.

Return Value

Type: System.String

Returns an identifier of the prepared command that can later be passed to the Execute or ExecuteWithoutResults methods using the command type Prepared.

Exceptions

Exception	Condition
ArgumentNullException	The command or asyncCommandEvents are null.
ArgumentException	The commandType specifies an invalid type.
ArgumentOutOfRangeException	The commandTimeout is less than -1.
NotSupportedException	The provider does not support this method.

Remarks

Other exceptions that occur indicate that the parameter derivation failed for a provider-specified reason.

Permissions

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.