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

Artikel
05/16/2015

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

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

Syntax

'Declaration
Public Overridable Function Execute ( _
    command As String, _
    commandType As DataCommandType, _
    parameters As IVsDataParameter(), _
    commandTimeout As Integer _
) As IVsDataReader

public virtual IVsDataReader Execute(
    string command,
    DataCommandType commandType,
    IVsDataParameter[] parameters,
    int commandTimeout
)

public:
virtual IVsDataReader^ Execute(
    String^ command, 
    DataCommandType commandType, 
    array<IVsDataParameter^>^ parameters, 
    int commandTimeout
)

abstract Execute : 
        command:string * 
        commandType:DataCommandType * 
        parameters:IVsDataParameter[] * 
        commandTimeout:int -> IVsDataReader  
override Execute : 
        command:string * 
        commandType:DataCommandType * 
        parameters:IVsDataParameter[] * 
        commandTimeout:int -> IVsDataReader

public function Execute(
    command : String, 
    commandType : DataCommandType, 
    parameters : IVsDataParameter[], 
    commandTimeout : int
) : IVsDataReader

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: Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataReader
Ein IVsDataReader-Objekt, das nur für Vorwärts-Recordsets, schreibgeschützten Stream aus der Datenquelle enthält.

Implementiert

IVsDataCommand.Execute(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

Keinerlei out-Parameter oder die Rückgabewertparameter, die im parameters von Array DataParameter-Objekten angegeben werden, können abgerufen werden, nachdem das zurückgegebene IVsDataReader geschlossen wurde. Dies ist aufgrund der unterschiedlichen Bestellungen, in denen Daten und Parameterwerte von einer Datenquelle zurückgegeben werden können.

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.