DataCommand.Prepare Method (String)

Article
2011-02-23

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

'Declaration
Public Function Prepare ( _
    command As String _
) As String

public string Prepare(
    string command
)

public:
virtual String^ Prepare(
    String^ command
) sealed

abstract Prepare : 
        command:string -> string 
override Prepare : 
        command:string -> string

public final function Prepare(
    command : String
) : String

Parameters

command
Type: System.String
A command to execute that is specific to a data source.

Return Value

Type: System.String
An identifier of the prepared command that can later be passed to the Execute(String, DataCommandType, array<DataParameter[], Int32) or ExecuteWithoutResults(String, DataCommandType, array<DataParameter[], Int32) method by using the command type Prepared.

Implements

IVsDataCommand.Prepare(String)

Exceptions

Exception	Condition
ArgumentNullException	The command parameter is nulla null reference (Nothing in Visual Basic).

Remarks

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

.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.

Share via