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

Preparerà il comando specificato nell'origine dati essere eseguito; il comando può quindi essere eseguito più volte, con parametri variabili.

Spazio dei nomi:  Microsoft.VisualStudio.Data.Framework
Assembly:  Microsoft.VisualStudio.Data.Framework (in Microsoft.VisualStudio.Data.Framework.dll)

Sintassi

'Dichiarazione
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

Parametri

• command
  Tipo: String

  A un comando di esecuzione specifico a un'origine dati.

• commandType
  Tipo: Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType

  Il tipo di comando che specifica come interpretare il contenuto del parametro command. Il tipo di comando potrebbe essere un valore di enumerazione DataCommandType o un tipo personalizzato di comando definito da un provider, che può essere passato forzare un cast da un integer all'enumerazione DataCommandType.

• parameters
  Tipo: array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]

  Una matrice di oggetti IVsDataParameter che rappresentano i parametri di comando per il tipo specificato di comando.

• commandTimeout
  Tipo: Int32

  La durata, in secondi, bloccare il client prima di annullare l'esecuzione e di ritornare al chiamante. Un valore pari a 0 indica che il timeout infinito; un valore pari a -1 indica un valore predefinito del provider.

Valore restituito

Tipo: String
Un identificatore di comando possibile che può successivamente essere passato all'Execute o al metodo ExecuteWithoutResults utilizzando il tipo Prepareddel comando.

Implementa

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

Eccezioni

Eccezione	Condizione
ArgumentNullException	Il parametro command è nullriferimento null (Nothing in Visual Basic).
ArgumentOutOfRangeException	Il parametro commandTimeout è minore di -1.

Note

Altre eccezioni che si verificano indicano che la preparazione non è riuscita per un motivo specifico momento.

Sicurezza di .NET Framework

• Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

DataCommand Classe

Overload Prepare

Spazio dei nomi Microsoft.VisualStudio.Data.Framework

DataCommand