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

Artikel
05/16/2015

Bereitet den angegebenen Befehl auf der Datenquelle vor ausgeführt werden; der Befehl kann, mit unterschiedlichen Parametern dann mehrmals ausgeführt werden.

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

Syntax

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

Parameter

command
Typ: String

Ein Befehl, der ausgeführt wird, der einer Datenquelle bestimmt ist.

commandType
Typ: Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType

Der Typ des Befehls, der angibt, wie die Inhalte des Parameters command interpretiert. Der Befehlstyp kann entweder ein Wert der DataCommandType-Enumeration oder ein benutzerdefinierter Befehlstyp sein, der einem Anbieter definiert wurde, der übergeben werden kann, indem eine Umwandlung einer ganzen Zahl der Enumeration DataCommandType erzwingt.

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

Ein Array von IVsDataParameter-Objekten, die für den angegebenen Befehlsparameter Befehlstyp darstellt.

commandTimeout
Typ: Int32

Die Zeitspanne, in Sekunden, bevor der Client dem das Abbrechen der Ausführung und das Zurückgeben zum Aufrufer blockieren. Ein Wert von 0 gibt unbegrenztem Timeout an; ein Wert von -1 gibt ein Anbieterstandard an.

Rückgabewert

Typ: String
Ein Bezeichner interpretations- des Befehls, der dem Execute oder der ExecuteWithoutResults-Methode später übergeben werden kann, indem der Befehlstyp Prepared verwendet.

Implementiert

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

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	Der command-Parameter ist nullein Nullverweis (Nothing in Visual Basic).
ArgumentOutOfRangeException	Der commandTimeout-Parameter ist kleiner als -1.

Hinweise

Andere Ausnahmen, die auftreten, geben an, dass die Vorbereitung für einen Anbieter-angegebenen Grund fehlgeschlagen ist.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.