DataCommand.Prepare-Methode

Bereitet den angegebenen Befehl auf der Datenquelle vor ausgeführt werden; der Befehl wird mehrmals, mit verschiedenen Parametern ausgeführt werden.

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

Syntax

'Declaration
Public Overridable Function Prepare ( _
    command As String, _
    commandType As Integer, _
    commandTimeout As Integer _
) As String

public virtual string Prepare(
    string command,
    int commandType,
    int commandTimeout
)

public:
virtual String^ Prepare(
    String^ command, 
    int commandType, 
    int commandTimeout
)

abstract Prepare : 
        command:string * 
        commandType:int * 
        commandTimeout:int -> string  
override Prepare : 
        command:string * 
        commandType:int * 
        commandTimeout:int -> string

public function Prepare(
    command : String, 
    commandType : int, 
    commandTimeout : int
) : String

Parameter

• command
  Typ: String

  Ein Befehl auszuführen, der einer Datenquelle.

• commandType
  Typ: Int32

  Der Befehlstyp für den angegebenen Befehl, der angibt, wie der Inhalt des command-Parameters interpretiert.

• commandTimeout
  Typ: Int32

  Die Zeit, in Sekunden, den Client vor dem Abbrechen der Ausführung und dem Rückgabe an den Aufrufer blockieren. Der Wert 0 gibt unbegrenztes Timeout an; ein Wert von -1 gibt einen Anbieterstandard an.

Rückgabewert

Typ: String
Gibt einen Bezeichner des vorbereiteten Befehl zurück, der dem Execute oder den ExecuteWithoutResults werden mithilfe des Befehlstyps Prepared später übergeben werden kann.

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	Der Befehl oder die asyncCommandEvents sind NULL.
ArgumentException	Das commandType gibt einen ungültigen Typ an.
ArgumentOutOfRangeException	Das commandTimeout ist kleiner als -1.
NotSupportedException	Der Anbieter unterstützt diese Methode nicht.

Hinweise

Andere Ausnahmen, die auftreten, geben an, dass die Parameterableitung 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.

Siehe auch

Referenz

DataCommand Klasse

Microsoft.VisualStudio.Data-Namespace

DataCommand