Método DataCommand.Execute

Artigo
10/26/2012

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

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

Sintaxe

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

public virtual DataReader Execute(
    string command,
    int commandType,
    DataParameter[] parameters,
    int commandTimeout
)

public:
virtual DataReader^ Execute(
    String^ command, 
    int commandType, 
    array<DataParameter^>^ parameters, 
    int commandTimeout
)

abstract Execute : 
        command:string * 
        commandType:int * 
        parameters:DataParameter[] * 
        commandTimeout:int -> DataReader 
override Execute : 
        command:string * 
        commandType:int * 
        parameters:DataParameter[] * 
        commandTimeout:int -> DataReader

public function Execute(
    command : String, 
    commandType : int, 
    parameters : DataParameter[], 
    commandTimeout : int
) : DataReader

Parâmetros

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

commandType
Tipo: System.Int32
O tipo de comando para o comando indicado, especificando como interpretar o conteúdo do parâmetro de command .

parameters
Tipo: array<Microsoft.VisualStudio.Data.DataParameter[]
Uma matriz de objetos de DataParameter para o tipo especificado de comando.Embora esse seja um parâmetro de entrada, o provedor de DDEX ainda pode definir para fora propriedades individuais no e nos parâmetros do valor de retorno.

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.DataReader
Retorna um objeto de DataReader , que fornece um fluxo somente para frente, somente leitura da fonte de dados.

Exceções

Exceção	Condição
ArgumentNullException	O comando ou os asyncCommandEvents são zero.
ArgumentException	Especifica o tipo de um tipo válido.
ArgumentOutOfRangeException	O commandTimeout é menor que -1.
NotSupportedException	O provedor não suporta esse método.

Comentários

Devido aos pedidos de variação de que os dados e os valores de parâmetro podem ser retornados por uma fonte de dados, out os parâmetros do valor de retorno especificado na matriz de parameters de objetos de DataParameter podem ser recuperados somente após DataReader retornado foi fechada.

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.