DataCommand.Execute-Methode

Artikel
05/16/2015

Führt einen angegebenen Befehl, optional mit Parametern und schreibgeschützte Ergebnisse der gibt aus.

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

Syntax

'Declaration
Public Overridable Function Execute ( _
    command As String, _
    commandType As Integer, _
    parameters As DataParameter(), _
    commandTimeout As Integer _
) As DataReader

public virtual DataReader Execute(
    string command,
    int commandType,
    DataParameter[] parameters,
    int commandTimeout
)

public:
virtual DataReader^ Execute(
    String^ command, 
    int commandType, 
    array<DataParameter^>^ parameters, 
    int commandTimeout
)

abstract Execute : 
        command:string * 
        commandType:int * 
        parameters:DataParameter[] * 
        commandTimeout:int -> DataReader  
override Execute : 
        command:string * 
        commandType:int * 
        parameters:DataParameter[] * 
        commandTimeout:int -> DataReader

public function Execute(
    command : String, 
    commandType : int, 
    parameters : DataParameter[], 
    commandTimeout : int
) : DataReader

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.

parameters
Typ: array<Microsoft.VisualStudio.Data.DataParameter[]

Ein Array von DataParameter gilt für den angegebenen Befehlstyp ein. Während dieses ein Eingabeparameter ist, ist der DDEX-Anbieter weiterhin in der Lage, Eigenschaften für einzelne und Rückgabewertparametern out festzulegen.

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: Microsoft.VisualStudio.Data.DataReader
Gibt ein Objekt zurück, das DataReader einen vorwärts, schreibgeschützten Stream von der Datenquelle bereitstellt.

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

Aufgrund der verschiedenen Bestellungen, in denen Daten und Parameterwerte von einer Datenquelle zurückgegeben werden können, alle out oder Rückgabewertparameter haben im parameters Array von DataParameter-Objekten können abgerufen werden an, nachdem zurückgegebene DataReader geschlossen wurde.

Hinweis

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.