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

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

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.

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

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.