DataCommand.DeriveParameters Method (String, DataCommandType, Int32)

Article
02/28/2011

Derives the parameters that can be specified for a given command.

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

Syntax

'Déclaration
Public Overridable Function DeriveParameters ( _
    command As String, _
    commandType As DataCommandType, _
    commandTimeout As Integer _
) As IVsDataParameter()

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

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

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

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

Parameters

command
Type: System.String
A command from which to derive parameters 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.

commandTimeout
Type: System.Int32
The length of time, in seconds, to block the client before canceling the parameter derivation and returning to the caller. A value of 0 indicates infinite time-out; a value of -1 indicates a provider default.

Return Value

Type: array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]
An array of IVsDataParameter objects. Each object represents a parameter derived from the command.

Implements

IVsDataCommand.DeriveParameters(String, DataCommandType, Int32)

Exceptions

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

Remarks

After the instances of the derived parameter objects are retrieved, the client owns them and can modify their values as needed. The client will then pass these values along with a command type set to Text and an appropriate time-out value to the Execute(String, DataCommandType, array<DataParameter[], Int32) or [M:Microsoft.VisualStudio.Data.Framework.DataCommand.ExecuteWithoutResults(System.String,T:Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType,Microsoft.VisualStudio.Data.Framework.DataParameter[],System.Int32)]

call.

Notes

Other exceptions that occur indicate that the parameter derivation 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