Método DataCommand.Execute (String, DataCommandType, array<IVsDataParameter , Int32)

Artigo
10/26/2012

Executa um comando especificado, opcionalmente com parâmetros, e somente leitura resulta de retorna.

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

Sintaxe

'Declaração
Public Overridable Function Execute ( _
    command As String, _
    commandType As DataCommandType, _
    parameters As IVsDataParameter(), _
    commandTimeout As Integer _
) As IVsDataReader

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

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

abstract Execute : 
        command:string * 
        commandType:DataCommandType * 
        parameters:IVsDataParameter[] * 
        commandTimeout:int -> IVsDataReader 
override Execute : 
        command:string * 
        commandType:DataCommandType * 
        parameters:IVsDataParameter[] * 
        commandTimeout:int -> IVsDataReader

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

Parâmetros

command
Tipo: System.String
Executar um comando que é específico a uma fonte de dados.

commandType
Tipo: Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType
O tipo de comando que especifica como interpretar o conteúdo do parâmetro de command .O tipo de comando poderia ser um valor de enumeração de DataCommandType ou um tipo de comando personalizado definida por um provedor, que pode ser passado forçando uma conversão de um inteiro para a enumeração de DataCommandType .

parameters
Tipo: array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]
Uma matriz de objetos de IVsDataParameter que representam os parâmetros do comando para o comando tipo especificado.

commandTimeout
Tipo: System.Int32
O período de tempo, em segundos, para bloquear o cliente antes de cancelar a execução e retornar para o chamador.Um valor de 0 indica o tempo limite infinito; um valor de -1 indica uma opção de provedor.

Valor de retorno

Tipo: Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataReader
Um objeto de IVsDataReader , que fornece um fluxo somente para frente, somente leitura da fonte de dados.

Implementações

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

Exceções

Exceção	Condição
ArgumentNullException	o parâmetro de command é nulluma referência nula (Nothing no Visual Basic).
ArgumentOutOfRangeException	O parâmetro de commandTimeout é menor que -1.

Comentários

Out os parâmetros do valor de retorno especificados na matriz de parameters de objetos de DataParameter podem ser recuperados somente após IVsDataReader retornado foi fechada.Isso é devido aos pedidos de variação de que os dados e os valores de parâmetro podem ser retornados por uma fonte de dados.

Observação
Outras exceções que ocorrem indica que a derivação de parâmetro falhou para um motivo provedor- especificada.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.