Execute-Methode (RDS)
Führt die Anforderung aus und erstellt ein ADO-Recordset für die Verwendung in ADO 2.5. und höher.
Wichtig
Ab Windows 8 und Windows Server 2012 sind RDS-Serverkomponenten nicht mehr im Windows-Betriebssystem enthalten (weitere Informationen finden Sie in den jeweiligen Kompatibilitäts-Cookbooks zu Windows 8 und Windows Server 2012). RDS-Clientkomponenten werden in einer zukünftigen Version von Windows entfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Anwendungen, die RDS verwenden, sollten zu WCF Data Service migriert werden.
Syntax
object.Execute(ConnectionString As String, HandlerString As String, QueryString As String, lFetchOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters, [lcid As Long], [pInformation])
Parameter
ConnectionString
Eine Zeichenfolge, die zum Herstellen einer Verbindung mit dem OLE DB-Anbieter verwendet wird, an den die Anforderung zur Ausführung gesendet wird. Wenn ein Handler mithilfe von HandlerString angegeben wird, kann er die Verbindungszeichenfolge bearbeiten oder ersetzen.
HandlerString
Eine zweiteilige Zeichenfolge, die den Handler identifiziert, der bei dieser Ausführung verwendet werden soll. Die Zeichenfolge enthält zwei Teile. Der erste Teil enthält den Namen (ProgID) des zu verwendenden Handlers. Der zweite Teil enthält Argumente, die an den Handler übergeben werden. Die Details dazu, wie die Argumentzeichenfolge interpretiert wird, sind für jeden Handler spezifisch. Die beiden Teile werden durch die erste Instanz eines Kommas in der Zeichenfolge getrennt. Die Argumentezeichenfolge kann zusätzliche Kommas enthalten. Die Argumente sind optional.
QueryString
Ein Befehl in der Befehlssprache, die vom OLE DB-Anbieter unterstützt wird (in der Verbindungszeichenfolge identifiziert). Bei SQL-basierten Anbietern kann QueryString eine Transact-SQL-Befehlsanweisung enthalten, aber bei Nicht-SQL-Anbietern (z. B. MSDataShape) handelt es sich möglicherweise nicht um eine Transact-SQL-Abfrageanweisung.
Wenn ein Handler verwendet wird, kann der Handler den hier angegebenen Wert ändern oder ersetzen. In der Regel ersetzt der Handler z. B. QueryString durch eine Abfragezeichenfolge aus der INI-Datei. Standardmäßig wird die Datei „Msdfmap.ini“ verwendet.
lFetchOptions
Gibt den Typ des asynchronen Abrufens an.
Weitere Informationen finden Sie unter FetchOptions Property (RDS).
TableID
Eine Variant vom Typ VT_EMPTY oder VT_BSTR. Wenn dieser Wert vom Typ VT_EMPTY ist, wird er ignoriert. Wenn es sich um den Typ VT_BSTR handelt, wird das Recordset mithilfe von adCmdTableDirect mit dem hier angegebenen Wert erstellt, und der QueryString-Parameter wird ignoriert.
lExecuteOptions
Eine Bitmaske mit Ausführungsoptionen:
1=ReadOnly Das Recordset wird mit adLockReadOnly geöffnet.
2=NoBatch Das Recordset wird mit adLockOptimistic geöffnet.
4=AllParamInfoSupplied Die aufrufende Funktion garantiert, dass in pParameters Parameterinformationen für alle Parameter bereitgestellt werden.
8=GetInfo Parameterinformationen für die Abfrage werden vom OLE DB-Anbieter abgerufen und im Parameter pParameters zurückgegeben. Die Abfrage wird nicht ausgeführt, und es wird kein Recordset zurückgegeben.
16=GetHiddenColumns Das Recordset wird mit adLockBatchOptimistic geöffnet. Ausgeblendete Spalten sind im Recordset enthalten.
ReadOnly, NoBatch und GetHiddenColumns sind Optionen, die sich gegenseitig ausschließen. Es führt jedoch nicht zu einem Fehler, wenn Sie mehr als eine dieser Optionen setzen. Bei Festlegung mehrerer Optionen hat GetHiddenColumns Vorrang vor allen anderen Optionen, gefolgt von ReadOnly. Wenn keine Optionen festgelegt werden, wird der Datensatz standardmäßig mit adLockBatchOptimistic geöffnet und ausgeblendete Spalten werden nicht in den Datensatz aufgenommen.
pParameters
Eine Variante, die ein sicheres Array von Parameterdefinitionen enthält Falls die Option GetInfo in lExecuteOptions angegeben wurde, wird dieser Parameter verwendet, um die vom OLE DB-Anbieter erhaltenen Parameterdefinitionen zurückzugeben. Andernfalls kann dieser Parameter leer sein.
lcid
Die LCID, die zum Erstellen von Fehlern verwendet wird, die in pInformation zurückgegeben werden.
pInformation
Ein Zeiger auf Informationen, der von Execute zurückgegeben wird. Wenn NULL, werden keine Fehlerinformationen zurückgegeben.
Bemerkungen
Der HandlerString-Parameter kann NULL sein. Was in diesem Fall geschieht, hängt davon ab, wie der RDS-Server konfiguriert ist. Die Handlerzeichenfolge „MSDFMAP.handler“ gibt an, dass der von Microsoft bereitgestellte Handler (Msdfmap.dll) verwendet werden soll. Die Handlerzeichenfolge „MASDFMAP.handler,sample.ini“ gibt an, dass der „Msdfmap.dll“-Handler verwendet und das Argument „sample.ini“ an den Handler übergeben werden soll. „MSDFMAP.dll“ interpretiert das Argument als Anweisung zur Verwendung der „sample.ini“, um die Verbindungs- und Abfragezeichenfolgen zu überprüfen.