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

Prepara o comando especificado na fonte de dados ser executado; o comando pode então ser executado várias vezes, com parâmetros de variação.

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

Sintaxe

'Declaração
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
  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: System.String
Um identificador de comando preparado que posteriormente pode ser passado para o Execute ou método de ExecuteWithoutResults usando o tipo Preparedde comando.

Implementações

IVsDataCommand.Prepare(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

Outras exceções que ocorrem indica que a preparação 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.

Consulte também

Referência

DataCommand Classe

Sobrecargas Prepare

Namespace Microsoft.VisualStudio.Data.Framework

DataCommand