Promotic
WikipediaLinkedInYoutubeTwitterFacebook

GetArray - metoda obiektu PmDatabase

Opis:
Wytworzy tablicę (array) lub macierz wartości wczytanych z wybranych kolumn tabeli. Metoda odczyta wszystkie wartości jednej lub kilku kolumn według ustawienia parametra vWhat.
Składnia:
GetArray(sType As String, vWhat As Variant) As Array
Wołanie:
array = oDatabase.GetArray(sType, vWhat)
Parametry:
sType(String) Typ wybranych wartości w tabeli:
"col" - zwracane będą dane jednej lib kilku kolumn tabeli (tzn. powstanie tablica 1-wymiarowa lub macierz danych) w zależności od wartości parametru vWhat.
"all" - Zwraca dane wszytkich kolumn tabeli, tzn. cała tabela (tzn. powstanie 2-wymiarowa macierz). Wartość vWhat musi być ustawiona na wartość Empty.
vWhat(Variant) Określa kolumny, których wartości będą zwrócone. Wartość vWhat musi być typu string, liczba całkowita lub tablica liczb całkowitych.
Jeżeli jest typu string, wtedy przedstawia nazwę kolumny lub łańcuch nazw kolumn oddzielone średnikiem, na przykład "col4;col5;col6".
Jeżeli jest liczbą rzeczywistą, wtedy vWhat>=0 oznacza indeks wybranej kolumny (vWhat=0 oznacza pierwszą kolumnę, vWhat=-2 oznacza ostatnią kolumna).
Jeżeli vWhat jest tablicą liczb całkowitych, wtedy liczby te okraślają indeksy kolumn tabeli, których dane zostaną zwrócone.
"xxx" - vWhat jest łańcuchem określającym nazwę kolumny, na przykład col4 lub łańcuchem nazw kolumn oddzielone średnikiem, na przykład "col4;col5;col6".
>=0 - liczba całkowita >=0 oznacza indeks wybranej kolumny (vWhat=0 oznacza perwszą kolumnę).
-2 - Wartość -2 oznacza zwrócenie danych ostatniej kolumny. Jeżeli vWhat jest tablicą liczb całkowitych, wtedy liczby te określają indeksy kolumn tabeli, których dane zostaną zwrócone.
array - Jeżeli vWhat jest tablicą liczb całkowitych (na przykład vWhat=Array(0,2,6)), wtedy liczby w tablicy oznaczają indeksy kolumn tabeli, których dane zostaną zwrócone.
Notatka:
Zastosowanie tej metody przy uzyskiwaniu dużej ilości danych z pokaźych tabel (dziesiątki tysięcy wierszy,...) może trwać znacząco dłuższy czas w zależności od konkretnej konfiguracji sprzętowej komputera. W tym przypadku trzeba przeprowadzać testy.
Przykład1:
Do arr zostanie przyszeregowana tablica 1-wymiarowa zawierająca wszystkie wartości z kolumny o nazwie variable1
VBScriptWybierz oraz skopiuj do schowka

arr = oDatabase.GetArray("col", "variable1")
Przykład2:
Do arr zostanie przyszeregowana tablica 1-wymiarowa zawierająca wszystkie wartości w trzeciej kolumnie (indeksowane od 0)
VBScriptWybierz oraz skopiuj do schowka

arr = oDatabase.GetArray("col", 2)
Przykład3:
Do arr zostanie przyszeregowana macierz, która w pierwszym wierszu zawiera wszystkie wartości z kolumny o nazwie variable1, w drugim wierszu zawiera wszystkie wartości z kolumny o nazwie variable2
VBScriptWybierz oraz skopiuj do schowka

arr = oDatabase.GetArray("col", "variable1;variable2")
Przykład4:
VBScriptWybierz oraz skopiuj do schowka

Dim cols
cols = Array(0, 1, 2)
arr = oDatabase.GetArray("col", cols)
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice