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 Details finden Sie unter Windows 8 und Windows Server 2012 Compatibility Cookbook). RDS-Clientkomponenten werden in einer zukünftigen Version von Windows entfernt. Vermeiden Sie die Verwendung dieses Features in neuer Entwicklungsarbeit, und planen Sie, Anwendungen zu ändern, die derzeit dieses Feature verwenden. Anwendungen, die RDS verwenden, sollten zu WCF Data Servicemigrieren.
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 HandlerString angegeben wird kann er die Verbindungszeichenfolge bearbeiten oder ersetzen.
HandlerString-
Eine zweiteilige Zeichenfolge, die den Handler identifiziert, der mit 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 sollen. Die Details dazu, wie die Argumentzeichenfolge interpretiert wird, sind spezifisch für jeden Handler. Die beiden Teile werden durch die erste Instanz eines Kommas in der Zeichenfolge getrennt. Die Argumentzeichenfolge kann zusätzliche Kommas enthalten. Die Argumente sind optional.
QueryString-
Ein Befehl in der Befehlssprache, die vom OLE DB-Anbieter unterstützt wird, der in der Verbindungszeichenfolge angegeben ist. Bei SQL-basierten Anbietern kann QueryString- eine Transact-SQL Befehlsanweisungen enthalten, aber bei Nicht-SQL-Anbietern (z. B. MSDataShape) ist dies möglicherweise keine Transact-SQL Abfrageanweisungen.
Wenn ein Handler verwendet wird, kann der Handler den hier angegebenen Wert ändern oder ersetzen. Beispielsweise ersetzt der Handler in der Regel QueryString- durch eine Abfragezeichenfolge aus der .ini Datei. Standardmäßig wird die Msdfmap.ini Datei verwendet.
lFetchOptions-
Gibt den Typ des asynchronen Abrufs an.
Weitere Informationen finden Sie unter FetchOptions-Eigenschaft (RDS)-.
TableID-
Ein Variant- vom Typ entweder VT_EMPTY oder VT_BSTR. Wenn dieser Wert vom Typ VT_EMPTY ist, wird er ignoriert. Wenn es vom Typ VT_BSTR ist, wird das Recordset mithilfe adCmdTableDirect- und des hier angegebenen Werts erstellt, und der QueryString--Parameter wird ignoriert.
lExecuteOptions-
Eine Bitmaske der Ausführungsoptionen:
1=ReadOnly The recordset will be opened by using adLockReadOnly.
2=NoBatch Das Recordset wird mit adLockOptimisticgeöffnet.
4=AllParamInfoSupplied Der Aufrufer garantiert, dass Parameterinformationen für alle Parameter in pParametersangegeben werden.
8=GetInfo Parameterinformationen für die Abfrage werden vom OLE DB-Anbieter abgerufen und im pParameters Parameter zurückgegeben. Die Abfrage wird nicht ausgeführt, und es wird kein Recordset zurückgegeben.
16=GetHiddenColumns The recordset will be opened by using adLockBatchOptimistic and any hidden columns will be included in the recordset.
ReadOnly, NoBatch und GetHiddenColumns sind sich gegenseitig ausschließende Optionen; Es wird jedoch kein Fehler generiert, um mehrere davon festzulegen. Wenn mehrere Optionen festgelegt sind, hat GetHiddenColumns Vorrang vor allen anderen, gefolgt von ReadOnly. Wenn keine Optionen angegeben sind, wird das Recordset standardmäßig mithilfe adLockBatchOptimistic- und ausgeblendeter Spalten nicht im Recordset enthalten.
pParameters
Ein Variant-, das ein sicheres Array von Parameterdefinitionen enthält. Wenn die option GetInfo in lExecuteOptionsangegeben wurde, wird dieser Parameter verwendet, um die vom OLE DB-Anbieter abgerufenen Parameterdefinitionen zurückzugeben. Andernfalls kann dieser Parameter leer sein.
lcid-
Die LCID, die zum Erstellen von Fehlern verwendet wird, die in pInformationzurückgegeben werden.
pInformation-
Ein Zeiger auf Informationen, der von Execute zurückgegeben wird. Wenn NULL, werden keine Fehlerinformationen zurückgegeben.
Bemerkungen
Der parameter HandlerString kann null sein. Was in diesem Fall geschieht, hängt davon ab, wie der RDS-Server konfiguriert ist. Eine Handlerzeichenfolge von "MSDFMAP.handler" gibt an, dass der von Microsoft bereitgestellte Handler (Msdfmap.dll) verwendet werden soll. Eine Handlerzeichenfolge von "MASDFMAP.handler,sample.ini" gibt an, dass der Msdfmap.dll-Handler verwendet werden soll und dass das Argument "sample.ini" an den Handler übergeben werden soll. MSDFMAP.dll interpretiert das Argument als Richtung für die Verwendung der sample.ini zum Überprüfen der Verbindungs- und Abfragezeichenfolgen.