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 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.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 von 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. Wie die Argumentezeichenfolge interpretiert wird, ist handlerspezifisch. Die beiden Teile werden durch die erste Instanz eines Kommas in der Zeichenfolge getrennt (auch wenn die Argumentezeichenfolge zusätzliche Kommas enthalten kann). 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 eine Transact-SQL-Befehlsanweisung enthalten sein. Bei Nicht-SQL-Anbietern (z. B. MSDataShape) kann dies keine Transact-SQL-Abfrageanweisung sein.
Wenn ein Handler verwendet wird (dies wird dringend empfohlen), 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.
lMarshalOptions
Wird verwendet, um die Marshallingoptionen für das zurückgegebene Rowset/Recordset festzulegen.
TableID
Eine Variante 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 der 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.
Obwohl ReadOnly, NoBatch und GetHiddenColumns sich gegenseitig ausschließen, wird kein Fehler ausgegeben, wenn diese Optionen gleichzeitig ausgewählt werden. Bei Festlegung mehrerer Optionen hat GetHiddenColumns Vorrang vor allen anderen Optionen, gefolgt von ReadOnly. Wenn keine Optionen angegeben werden, wird das Recordset standardmäßig mithilfe von adLockBatchOptimistic geöffnet. Ausgeblendete Spalten sind im Recordset jedoch nicht enthalten.
pParameters
Eine Variante, die ein sicheres Array aus Parameterdefinitionen enthält. Wenn die GetInfo-Option in lExecuteOptions angegeben wurde, wird dieser Parameter verwendet, um die Parameterdefinitionen zurückzugeben, die vom OLE DB-Anbieter abgerufen wurden. Andernfalls kann dieser Parameter leer sein.
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.
Hinweis
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.