| sId | (String) Jednoznaczny identyfikator tekstowy, pod którym obiekt PmaAdo utrzyma rezultat polecenia w formie obiektu AdoRecordset.
Jeżeli jest wprowadzony pusty łańcuch (""), wtedy polecenie SQL wprawdzie zostanie wykonane i rezultat w formie obiektu AdoRecordset zostanie zwrócony, lecz obiekt PmaAdo nie będzie go utrzymywać. To jest dogodne zwłaszcza w przypadkach, kiedy w skrypcie jest konieczne wykonać zapytanie SQL i dane w skrypcie bezpośrednio opracować z tym, że obiekt AdoRecordset zostanie bezpośrednio po tym zwolniony. Pusty łańcuch należy również wprowadzić, jeżeli wprowadzone polecenie wogóle nie zwraca dane wynikowe. |
|---|---|
| sCommand | (String) Zazwyczaj polecenie w składni języka SQL (INSERT, UPDATE, DELETE, itd.), które nie zwraca danych w formie obiektu AdoRecordset.
Może jednak również zwracać dane w formie obiektu AdoRecordset i zawierać zapytanie SQL SELECT, nazwę tabeli, wywołanie procedury składowanej, nazwa lub Adres URL pliku zawierającego zapisany obiekt AdoRecordset. |
| sParams | (String) Dodatkowe parametry metody DbExecute. Dane są tutaj w formacie KeyVal, na przykład "command:text;execute:norecords;return:map;".
"command:xxx;" (opcjonalne) - Określa, w jaki sposób ADO Provider ma podsumować parametr sSource, zwłaszcza jeżeli zawiera coś innego, niż polecenie w składni języka SQL (np. SELECT, INSERT, itd.).
text (domyślnie) - Określa, że ADO Provider ma zastosować parametr sSource jako tekstowy zapis polecenia.
Odpowiada to wartości ADO adCmdText. table - Określa, że ADO Provider ma wytworzyć zapytanie SQL w taki sposób, że zostaną zwrócone wszystkie rekordy tabeli bazodanowej, której nazwa jest przedstawiona w parametrze sSource.
Odpowiada to wartości ADO adCmdTable. storedproc - Określa, że ADO Provider ma zastosować parametr sSource jako procedurę składowaną.
Odpowiada to wartości ADO adCmdStoredProc. file - Określa, że zapisany obiekt AdoRecordset ma zostać wczytany z pliku, którego nazwa jest przedstawiona w parametrze sSource.
Odpowiada to wartości ADO adCmdFile. tabledirect - Określa, że ADO Provider ma zwrócić wszystkie rekordy tabeli bazodanowej w bazie danych, której nazwa jest przedstawiona w parametrze sSource.
Odpowiada to wartości ADO adCmdTableDirect. unknown - Określa, że tzp polecenia w parametrze sSource nie jest znany. ADO Provider spróbuje sam określić jego typ, lecz wymaga to dodatkowego czasu.
Odpowiada to wartości ADO adCmdUnknown. "execute:xxx;" (opcjonalne) - Określa, w jaki sposób ADO Provider ma wykonać zapytanie SQL. Domyślnym jest zapytanie synchroniczne, to znaczy, że metoda oczekuje na wynik operacji.
async - Asynchroniczne zapytanie, to znaczy, że metoda nie czeka na wynik operacji.
Odpowiada to wartości ADO adAsyncExecute. asyncfetch - Określa, że wiersze określone właściwością AdoRecordset.CacheSize mają być odczytywane synchronicznie, i pozostające wiersze majązostać odczytane asynchronicznie.
Odpowiada to wartości ADO adAsyncFetch. asyncfetchnonblocking - Określa, że główny wątek (thread) nie będzie nigdy blokowane przy odczycie.
Jeżeli wymagany wiersz nie zosta wczytany, wtedy wskaźnik bieżącego rekordu zostanie przesunięty na koniec. Odpowiada to wartości ADO adAsyncFetchNonBlocking. norecords - Określa, że wywołane zapytanie/polecenie nie zwraca żadnych danych.
Jeżeli polecenie zwraca dane, wtedy zostaną one zignorowane i nie zostaną zwrócone (żaden obiekt AdoRecordset = wartość null dla JavaScript lub Nothing dla VBScript). Odpowiada to wartości ADO adExecuteNoRecords. record - Określa, że wywołane zapytanie/polecenie zwraca jeden wiersz, który ma zostać zwrócony w formie obiektu AdoRecord.
Odpowiada to wartości ADO adExecuteRecord. "return:xxx;" (opcjonalne) - Określa, czy wartość zwrotna metody ma być mapą z większą ilością zwróconych wartości równocześnie (nowy sposób) lub tylko jedną wartością (stary sposób).
Jeżeli nie jest ustawione, wtedy zostanie zastosowany stary sposób. map - Zwraca mapę (obiekt PmMap), która zawiera większą ilość zwróconych wartości równocześnie (nowy sposób) (np. Result, AffectedRows, ErrorCode, ErrorText). |
var oDb = pMe.Pm("/TestAdoDb");
oDb.DbExecute("", "INSERT table1 (name, value) VALUES ('pi', 3.14)", "");