DataCommand.ExecuteWithoutResults Method (String, DataCommandType, array<IVsDataParameter )

Article
02/28/2011

Executes a command, optionally with parameters, but does not request results, instead returning an integer indicating the outcome of the call.

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

Syntax

'Déclaration
Public Function ExecuteWithoutResults ( _
    command As String, _
    commandType As DataCommandType, _
    parameters As IVsDataParameter() _
) As Integer

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

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

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

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

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: array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]
An array of IVsDataParameter objects representing the command parameters for the specified command type.

Return Value

Type: System.Int32
A DDEX provider–specific integer status code.

Implements

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

Exceptions

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

Remarks

In many cases, the outcome of the call to this method will indicate the number of rows affected.

You can set out and return value parameters by using this call. They are not considered part of the results.

Notes

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

Partager via