sId | (String) Jednoznačný textový identifikátor, pod kterým si objekt PmaAdo zapamatuje výsledná data v podobě objektu AdoRecordset.
Pokud je uveden prázdný řetězec (""), pak se SQL příkaz sice provede a data v podobě objektu AdoRecordset jsou vrácena, ale objekt PmaAdo si je nebude pamatovat. Je to výhodné zejména v případech, kdy je nutno ve skriptu provést SQL dotaz a data ve skriptu ihned zpracovat s tím, že objekt AdoRecordset se ihned poté uvolní. Prázdný řetězec se také zadává, pokud zadaný příkaz výsledná data vůbec nevrací. |
---|---|
sCommand | (String) Obvykle příkaz v syntaxi jazyka SQL (INSERT, UPDATE, DELETE, atd.), který nevrací data v podobě objektu AdoRecordset.
Může ale také také vracet data v podobě objektu AdoRecordset a obsahovat SQL dotaz SELECT, název tabulky, volání uložené procedury, název nebo URL adresa souboru obsahující uložený objekt AdoRecordset. |
sParams | (String) Dodatečné parametry metody DbExecute. Údaje jsou zde ve formátu KeyVal, například "command:text;execute:norecords;return:map;".
"command:xxx;" (nepovinné) - Určuje, jak má příslušný ADO Provider vyhodnotit parametr sSource, zejména pokud obsahuje něco jiného, než dotaz/příkaz v syntaxi jazyka SQL (např. SELECT, INSERT, atd.).
text (přednastaveno) - Určuje, že ADO Provider má vyhodnotit parametr sSource jako textový zápis příkazu.
To odpovídá hodnotě ADO adCmdText. table - Určuje, že ADO Provider má vygenerovat SQL dotaz tak, že budou vráceny všechny záznamy databázové tabulky, jejíž název je uvedené v parametru sSource.
To odpovídá hodnotě ADO adCmdTable. storedproc - Určuje, že ADO Provider má vyhodnotit parametr sSource jako uloženou proceduru.
To odpovídá hodnotě ADO adCmdStoredProc. file - Určuje, že uložený objekt AdoRecordset má být vyčten ze souboru, jehož název je uvedený v parametru sSource.
To odpovídá hodnotě ADO adCmdFile. tabledirect - Určuje, že ADO Provider má vrátit všechny záznamy databázové tabulky, jejíž název je uvedené v parametru sSource.
To odpovídá hodnotě ADO adCmdTableDirect. unknown - Určuje, že typ příkazu v parametru sSource není známý. ADO Provider se ho pokusí zjistit sám, ale spotřebuje se tím zbytečně čas.
To odpovídá hodnotě ADO adCmdUnknown. "execute:xxx;" (nepovinné) - Určuje, jak má příslušný ADO Provider provést SQL dotaz. Implicitní je synchronní dotaz, to znamená, že metoda čeká na výsledek operace.
async - Asynchronní dotaz, to znamená, že metoda nečeká na výsledek operace.
To odpovídá hodnotě ADO adAsyncExecute. asyncfetch - Určuje, že řádky určené vlastností AdoRecordset.CacheSize se mají načíst synchronně, a zbývající řádky se mají dočíst asynchronně.
To odpovídá hodnotě ADO adAsyncFetch. asyncfetchnonblocking - Určuje, že hlavní vlákno (thread) nebude nikdy blokováno při čtení.
Pokud požadovaný řádek nebyl načten, pak ukazovátko aktuálního záznamu bude přesunuto na konec. To odpovídá hodnotě ADO adAsyncFetchNonBlocking. norecords - Určuje, že volaný dotaz/příkaz nevrací žádná data.
Pokud ano, pak data budou zahozena a nebudou vrácena (žádný objekt AdoRecordset = hodnota null pro JavaScript nebo Nothing pro VBScript). To odpovídá hodnotě ADO adExecuteNoRecords. record - Určuje, že volaný dotaz/příkaz vrací jeden řádek, který má být vrácen v podobě objektu AdoRecord.
To odpovídá hodnotě ADO adExecuteRecord. "return:xxx;" (nepovinné) - Určuje, zda vrácená hodnota metody má být mapa s více vrácenými hodnotami současně (nový způsob) nebo jedna hodnota (starý způsob).
Pokud není nastaveno, pak se jedná o starý způsob. map - Vrací mapu (objekt PmMap), která obsahuje více vrácených hodnot současně (nový způsob) (např. Result, AffectedRows, ErrorCode, ErrorText). |
var oDb = pMe.Pm("/TestAdoDb");
oDb.DbExecute("", "INSERT table1 (name, value) VALUES ('pi', 3.14)", "");