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

Artículo
11/02/2012

Prepara el comando especificado en el origen de datos de ejecutarse; el comando puede ser ejecutado varias veces, con parámetros diferentes.

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

Sintaxis

'Declaración
Public Overridable Function Prepare ( _
    command As String, _
    commandType As DataCommandType, _
    parameters As IVsDataParameter(), _
    commandTimeout As Integer _
) As String

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

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

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

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

Parámetros

command
Tipo: System.String
Un comando de ejecución que es específico de un origen de datos.

commandType
Tipo: Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType
El tipo de comando que especifica cómo interpretar el contenido del parámetro de command .El tipo de comando puede ser un valor de enumeración de DataCommandType o un tipo de comando personalizado definido por un proveedor, que puede ser pasado fuerza una conversión de un entero en la enumeración de DataCommandType .

parameters
Tipo: array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]
Una matriz de IVsDataParameter se opone representa los parámetros de comando para el tipo de comando especificado.

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: System.String
Un identificador de comando preparado que puede pasarse más tarde para Execute o al método de ExecuteWithoutResults utilizando el tipo de comando Prepared.

Implementaciones

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

Excepciones

Excepción	Condición
ArgumentNullException	El valor del parámetro command es nullreferencia null (Nothing en Visual Basic).
ArgumentOutOfRangeException	El parámetro commandTimeout es menor que -1.

Comentarios

Otras excepciones que aparecen indican que la preparación 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.