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

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 Function Prepare ( _
    command As String, _
    commandType As DataCommandType, _
    parameters As IVsDataParameter() _
) As String

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

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

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

public final function Prepare(
    command : String, 
    commandType : DataCommandType, 
    parameters : IVsDataParameter[]
) : 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.

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[])

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