DataCommand.Execute (Método)

Artículo
11/02/2012

Ejecuta un comando especificado, opcionalmente con parámetros, y readonly de retornos de resultados.

Espacio de nombres: Microsoft.VisualStudio.Data
Ensamblado: Microsoft.VisualStudio.Data (en Microsoft.VisualStudio.Data.dll)

Sintaxis

'Declaración
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
Un comando de ejecución que es específico de un origen de datos.

commandType
Tipo: System.Int32
El tipo de comando para el comando indicado, especificando cómo interpretar el contenido del parámetro de command .

parameters
Tipo: array<Microsoft.VisualStudio.Data.DataParameter[]
Una matriz de DataParameter se opone para el tipo de comando especificado.Aunque esto es un parámetro de entrada, el proveedor de DDEX todavía puede establecer propiedades en individuales out y parámetros de valor devuelto.

commandTimeout
Tipo: System.Int32
El tiempo, en segundos, de bloquear el cliente antes de cancelar la ejecución y volver al llamador.Un valor de 0 indica que el tiempo de espera infinito; el valor -1 indica un valor predeterminado del proveedor.

Valor devuelto

Tipo: Microsoft.VisualStudio.Data.DataReader
Devuelve un objeto de DataReader , que proporciona una secuencia adelantada - solo, de sólo lectura del origen de datos.

Excepciones

Excepción	Condición
ArgumentNullException	El comando o los asyncCommandEvents es null.
ArgumentException	El commandType especifica un tipo no válido.
ArgumentOutOfRangeException	El commandTimeout es menor que -1.
NotSupportedException	El proveedor no admite este método.

Comentarios

Debido a los pedidos diferentes en las que los datos y los valores de parámetro se pueden devolver por un origen de datos, out o los parámetros de valor devuelto especificado en la matriz de parameters de los objetos de DataParameter pueden recuperar únicamente después de que se ha cerrado DataReader devuelto.

[!NOTA]

Otras excepciones que aparecen indican que la derivación de parámetro falla por un motivo proveedor- especificada.

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.