Metoda deschisa (ADO Recordset)

• 18.09.2015
• 5 minute de citit

• • o

  • O

  • l

In acest articol

Se aplica : Access 2013, Office 2013

Deschide un cursor.

Sintaxa

set de inregistrari .Open Source , ActiveConnection , CursorType , LockType , Options

Parametrii

Parametru Descriere Sursa Optional. O varianta care evalueaza un obiect de comanda valid, o instructiune SQL, un nume de tabel, un apel de procedura stocata, o adresa URL sau numele unui fisier sau a unui obiect Stream care contine un set de inregistrari stocat permanent. ActiveConnection Optional. Fie o varianta care evalueaza un nume de variabila obiect de conexiune valida, fie un sir care contine parametri ConnectionString. CursorType Optional. O valoare CursorTypeEnum care determina tipul de cursor pe care furnizorul ar trebui sa il utilizeze la deschiderea setului de inregistrari . Valoarea implicita este adOpenForwardOnly . LockTypeOptional. O valoare LockTypeEnum care determina ce tip de blocare (concurenta) ar trebui sa utilizeze furnizorul la deschiderea setului de inregistrari . Valoarea implicita este adLockReadOnly . Optiuni Optionale. O valoare lunga care indica modul in care furnizorul ar trebui sa evalueze argumentul sursa daca reprezinta altceva decat un obiect Command sau daca setul de inregistrari ar trebui restaurat dintr-un fisier unde a fost salvat anterior. Poate fi una sau mai multe valori CommandTypeEnum sau ExecuteOptionEnum, care pot fi combinate cu un operator SI bit.

Valorile ExecuteOpenEnum ale adExecuteNoRecords sau adExecuteStream nu trebuie utilizate cu Open .

Observatii

Cursorul implicit pentru un set de inregistrari ADO este un cursor numai in avans, numai in citire, situat pe server.

Utilizarea metodei Deschidere pe un obiect Recordset deschide un cursor care reprezinta inregistrarile dintr-un tabel de baza, rezultatele unei interogari sau dintr-un Recordset salvat anterior .

Utilizati argumentul Sursa optional pentru a specifica o sursa de date utilizand una dintre urmatoarele: o variabila obiect Command , o instructiune SQL, o procedura stocata, un nume de tabel, un URL sau un nume complet al caii fisierului. Daca Sursa este un nume de cale a fisierului, poate fi o cale completa („c: \ dir \ file.rst”), o cale relativa („.. \ file.rst”) sau o adresa URL („https: // files / file.rst “).

Nu este o idee buna sa utilizati argumentul sursa al metodei Open pentru a efectua o interogare de actiune care nu returneaza inregistrari, deoarece nu exista o modalitate usoara de a determina daca apelul a reusit. Recordset returnat de o astfel de interogare a va fi inchisa. Apelati metoda Execute a unui obiect Command sau metoda Execute a unui obiect Connection pentru a efectua o interogare care, cum ar fi o instructiune SQL INSERT, care nu returneaza inregistrari.

De ActiveConnection corespunde argument in proprietatea ActiveConnection si specifica in care conexiunea pentru a deschide Recordset obiectului. Daca treceti o definitie a conexiunii pentru acest argument, ADO deschide o noua conexiune utilizand parametrii specificati. Dupa deschiderea setului de inregistrari cu un cursor partea clientului ( CursorLocation = adUseClient ), puteti modifica valoarea acestei proprietati pentru a trimite actualizari catre alt furnizor. Sau puteti seta aceasta proprietate la Nothing (in Microsoft Visual Basic) sau NULL pentru a deconecta setul de inregistrari de la orice furnizor. Cu toate acestea, modificarea ActiveConnection pentru un cursor de pe partea serverului genereaza o eroare.

Pentru celelalte argumente care corespund direct proprietatilor unui obiect Recordset ( Sursa , CursorType si LockType ), relatia argumentelor cu proprietatile este urmatoarea:

• Proprietatea este citita / scrisa inainte ca obiectul Recordset sa fie deschis.

• Setarile proprietatii sunt utilizate cu exceptia cazului in care treceti argumentele corespunzatoare atunci cand executati metoda Open . Daca treceti un argument, acesta suprascrie setarea proprietatii corespunzatoare, iar setarea proprietatii este actualizata cu valoarea argumentului.

• Dupa ce deschideti obiectul Recordset , aceste proprietati devin numai in citire.

Daca treceti un obiect Command in argumentul Sursa si treceti si un argument ActiveConnection , apare o eroare. Proprietatea ActiveConnection a obiectului Command trebuie sa fie deja setata la un obiect Connection valid sau un sir de conexiune.

Daca treceti altceva decat un obiect Command in argumentul Sursa , puteti utiliza argumentul Optiuni pentru a optimiza evaluarea argumentului Sursa . Daca argumentul Optiuni nu este definit, este posibil sa aveti performante reduse, deoarece ADO trebuie sa efectueze apeluri catre furnizor pentru a determina daca argumentul este o instructiune SQL, o procedura stocata, o adresa URL sau un nume de tabel. Daca stiti ce tip de sursa utilizati, setarea argumentului Optiuni instruieste ADO sa treaca direct la codul relevant. Daca argumentul Optiuni nu se potriveste cu tipul Sursa , apare o eroare.

Daca treceti un obiect Stream in argumentul Sursa , nu ar trebui sa treceti informatii in celelalte argumente. Acest lucru va genera o eroare. Informatiile ActiveConnection nu sunt pastrate atunci cand un set de inregistrari este deschis dintr-un flux .

Valoarea implicita pentru argumentul Optiuni este adCmdFile daca nu este asociata nicio conexiune cu setul de inregistrari . Acesta va fi, de obicei, cazul obiectelor Recordset stocate permanent .

Daca sursa de date nu returneaza nicio inregistrare, furnizorul stabileste atat proprietatile BOF, cat si EOF la True , iar pozitia actuala a inregistrarii este nedefinita. Puteti adauga in continuare date noi la acest obiect Recordset gol daca tipul de cursor o permite.

Dupa ce ati incheiat operatiunile pe un obiect Recordset deschis , utilizati metoda Close pentru a elibera orice resurse de sistem asociate. Inchiderea unui obiect nu il elimina din memorie; ii puteti modifica setarile de proprietate si puteti utiliza metoda Deschidere pentru ao deschide din nou mai tarziu. Pentru a elimina complet un obiect din memorie, setati variabila obiect la Nimic .

Inainte de ActiveConnection proprietatea este setata, suna deschis fara operanzi pentru a crea o instanta a unui Recordset creat prin adaugarea campurilor la Recordset colectia Fields.

Daca ati setat proprietatea CursorLocation la adUseClient , puteti prelua randuri in mod asincron intr-unul din cele doua moduri. Metoda recomandata este sa setati Optiuni la adAsyncFetch . Alternativ, puteti utiliza proprietatea dinamica „Asynchronous Rowset Processing” din colectia Properties, dar evenimentele recuperate asociate pot fi pierdute daca nu setati parametrul Options la adAsyncFetch .