Execute21-Methode (RDS)
Führt die Anforderung aus und erstellt ein ADO-Recordset für die Verwendung in ADO 2.1.
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.Execute21(ConnectionString As String, HandlerString As String, QueryString As String, lMarshalOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters)
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-
Die Zeichenfolge identifiziert den Handler, 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 der Zeichenfolge enthält Argumente, die an den Handler übergeben werden sollen. Die Interpretation der Argumentzeichenfolge ist handlerspezifisch. Die beiden Teile werden durch die erste Instanz eines Kommas in der Zeichenfolge getrennt (obwohl die Argumentzeichenfolge zusätzliche Kommas enthalten kann). 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 sie eine Transact-SQL Befehlsanweisungen enthalten, aber für Nicht-SQL-Anbieter (z. B. MSDataShape) ist dies möglicherweise keine Transact-SQL Abfrageanweisungen.
Wenn ein Handler verwendet wird (und es dringend empfohlen wird, einen Handler zu verwenden), 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.
lMarshalOptions
Wird verwendet, um die Marshaling-Optionen für das zurückgegebene Rowset/Recordset festzulegen.
TableID-
Eine Variante 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 mit dem hier angegebenen Wert erstellt, und der QueryString Parameter wird ignoriert.
lExecuteOptions-
Eine Bitmaske mit 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.
Obwohl ReadOnly, NoBatch und GetHiddenColumns sich gegenseitig ausschließen, ist es kein Fehler, mehrere davon festzulegen. Wenn mehrere Optionen festgelegt sind, hat GetHiddenColumns Vorrang vor allen anderen Optionen, gefolgt von ReadOnly. Wenn keine Optionen angegeben sind, wird das Recordset standardmäßig mit adLockBatchOptimistic geöffnet, aber ausgeblendete Spalten sind nicht im Recordset enthalten.
pParameters
Eine Variante, die 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.
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.
Anmerkung
Die Execute21--Methode ist eine Version der Execute-Methode (RDS). Wenn Sie die Execute-Methode für die Kommunikation mit ADO 2.1 verwenden müssen, kann stattdessen die Execute21--Methode aufgerufen werden. Die Funktionen der Execute-Methode in ADO 2.5 und höher sind eine Obermenge der Funktionen, die für dieselbe Methode in ADO 2.1 bereitgestellt werden.