DataCommand.Prepare Method (String, DataCommandType, [], Int32)

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

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

Syntax

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

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

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

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

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

Parameters

• command
  Type: System.String

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

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

  The type of the command that specifies how to interpret the contents of the command parameter. The command type could either be a value from the DataCommandType enumeration or a custom command type defined by a provider, which can be passed in by forcing a cast from an integer to the DataCommandType enumeration.

• parameters
  Type: []

  An array of IVsDataParameter objects representing the command parameters for the specified command type.

• 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 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 Execute(String, DataCommandType, [], Int32) or ExecuteWithoutResults(String, DataCommandType, [], Int32) method by using the command type Prepared.

Implements

IVsDataCommand.Prepare(String, DataCommandType, [], Int32)

Exceptions

Exception	Condition
ArgumentNullException	The command parameter is a null reference (Nothing in Visual Basic).
ArgumentOutOfRangeException	The commandTimeout parameter is less than -1.

Remarks

Other exceptions that occur indicate that the preparation 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.

See Also

Reference

DataCommand Class

DataCommand Members

Prepare Overload

Microsoft.VisualStudio.Data.Framework Namespace

DataCommand