Źródła danych: Programowego konfigurowania źródła danych ODBC
W tym temacie wyjaśniono, jak można programowo skonfigurować nazwy źródła danych Open Database Connectivity (ODBC).Zapewnia to elastyczność dostępu do danych bez wymuszania użytkownik jawnie użyć Administratora ODBC lub innych programów, aby określić nazwy źródeł danych.
Zazwyczaj użytkownik uruchamia Administratora ODBC, aby utworzyć źródło danych, jeśli system zarządzania skojarzonej bazie danych (DBMS) obsługuje tej operacji.
Podczas tworzenia źródła danych ODBC programu Microsoft Access przez administratora ODBC, podane są dwie opcje: można wybrać istniejący plik mdb lub utworzyć nowy plik mdb.Istnieje programowy sposób tworzenia pliku mdb z aplikacji MFC ODBC.W związku z tym jeśli aplikacja wymaga umieszczenia danych do źródła danych programu Microsoft Access (plik mdb), najprawdopodobniej ma być plik mdb puste, można użyć lub skopiować potrzebne.
Jednak wielu systemach DBMS umożliwiają tworzenie źródła danych programistyczny.Niektóre źródła danych utrzymania specyfikacji katalogu dla baz danych.Oznacza to, że katalog jest źródło danych i każdej tabeli w źródle danych jest przechowywane w oddzielnym pliku (w przypadku dBASE, każda tabela jest plik .dbf).Sterowniki dla innych baz danych ODBC, takich jak Microsoft Access i SQL Server wymagają, że niektóre szczególne kryteria zostać spełnione, zanim będzie można określić źródło danych.Na przykład używając sterownika ODBC dla programu SQL Server, trzeba ustanowiły komputera serwera SQL.
Przykład SQLConfigDataSource
W poniższym przykładzie użyto :: SQLConfigDataSource funkcji interfejsu API ODBC, aby utworzyć nowe źródło danych programu Excel nazywany nowego źródła danych programu Excel:
SQLConfigDataSource(NULL,ODBC_ADD_DSN, "Excel Files (*.xls)",
"DSN=New Excel Data Source\0"
"Description=New Excel Data Source\0"
"FileType=Excel\0"
"DataDirectory=C:\\EXCELDIR\0"
"MaxScanRows=20\0");
Należy zauważyć, że źródło danych jest w rzeczywistości katalogiem (C:\EXCELDIR); Ten katalog musi istnieć.Sterownik programu Excel używa katalogów jako jej źródła danych i plików jako poszczególnych tabel (jednej tabeli na plik .xls).
Aby uzyskać więcej informacji na temat tworzenia tabel, zobacz źródła danych: programowe tworzenie tabeli w źródle danych ODBC.
Następujące informacje omówiono parametry, które muszą zostać przekazane do :: SQLConfigDataSource funkcji interfejsu API ODBC.Aby użyć :: SQLConfigDataSource, należy dołączyć plik nagłówkowy Odbcinst.h i korzystanie z biblioteki import Odbcinst.lib.Ponadto Odbccp32.dll musi być w ścieżce w czasie wykonywania (lub Odbcinst.dll dla 16-bitowego).
Można utworzyć nazwy źródła danych ODBC za pomocą Administratora ODBC lub podobnego narzędzia.Jednak czasami jest pożądane, aby utworzyć nazwy źródła danych bezpośrednio z aplikacji, aby uzyskać dostęp bez konieczności użytkownika uruchomić narzędzie oddzielnych.
Administratora ODBC (zwykle zainstalowane w Panelu sterowania) tworzy nowe źródło danych, umieszczając wpisów w rejestrze systemu Windows (lub dla 16-bitowe, w pliku Odbc.ini).Menedżer sterowników ODBC kwerendy tego pliku, aby uzyskać wymagane informacje o źródle danych.Warto wiedzieć, jakie informacje musi być umieszczona w rejestrze, ponieważ trzeba dostarczyć wywołanie :: SQLConfigDataSource.
Chociaż te informacje można zapisać bezpośrednio do rejestru bez korzystania z :: SQLConfigDataSource, dowolnej aplikacji, które jest polegając na bieżący technika, której używa Menedżer sterownika do utrzymania jej danych.Jeśli później poprawek do przechowywania informacji o źródłach danych w inny sposób rekordu implementuje menedżera sterownika ODBC, każdej aplikacji korzystającej z tej techniki jest przerywane.Ogólnie zaleca jest dostarczony za pomocą funkcji interfejsu API.Na przykład, kod jest przenośny z 16-bitowy, 32-bitowy, jeśli używasz :: SQLConfigDataSource działać, ponieważ funkcja poprawnie zapisuje w pliku Odbc.ini lub w rejestrze.
Parametry SQLConfigDataSource
Wyjaśnia, następujące parametry :: SQLConfigDataSource funkcji.Wiele z tych informacji jest pobierana z interfejsu API ODBC Programmer's Reference dostarczonych z programem Visual C++ w wersji 1.5 i później.
.gif "ck4z6wwt.collapse_all(pl-pl,VS.110).gif")
Prototyp
BOOL SQLConfigDataSource(HWND hwndParent,UINT fRequest, LPCSTR lpszDriver, LPCSTR lpszAttributes);
Uwagi
Parametry i użycie
hwndParent
Okno określony jako właściciel żadnych okien dialogowych menedżera sterownika ODBC lub konkretny sterownik ODBC tworzy uzyskanie dodatkowych informacji od użytkownika o nowe źródło danych.Jeśli lpszAttributes parametr nie dostarcza wystarczających informacji, zostanie wyświetlone okno dialogowe.HwndParent parametr może być NULL.lpszDriver
Opis sterownika.Jest to nazwa, przedstawione do użytkowników, a nie nazwę sterownika fizyczne (DLL).lpszAttributes
Lista atrybutów w formie "keyname = wartość".Łańcuchy te są oddzielone niezakończone wartościami null z dwóch kolejnych null terminatory na końcu listy.Te atrybuty są przede wszystkim domyślnego sterownika zapisów, które go do rejestru dla nowego źródła danych.Jeden ważny klucz, który nie jest wymieniony w odwołaniu do interfejsu API ODBC dla tej funkcji jest "DSN" ("danych źródłowych nazwa"), który określa nazwę nowego źródła danych.Pozostałe pozycje są specyficzne dla sterownika dla nowego źródła danych.Często nie jest konieczne do dostarczania wszystkich wpisów, ponieważ sterownik może być monitowany w oknach dialogowych dla nowych wartości.(Ustawianie hwndParent do NULL to spowodować.) Należy podać wartości domyślne, dzięki czemu użytkownik nie jest monitowany o.
Aby określić opis sterownika dla parametru lpszDriver za pomocą Administratora ODBC
Uruchom Administratora ODBC.
Kliknij dodać.
Zawiera listę zainstalowanych sterowników i ich opisy.Użyj tego opisu jako lpszDriver parametru.Należy zauważyć, że cały opis, takie jak "Plików programu Excel (*.xls)", łącznie z rozszerzenia nazwy pliku i nawiasów, jeżeli znajdują się one w opisie.
Alternatywnie można zbadać rejestru (lub dla 16-bitowego pliku Odbcinst.ini), który zawiera listę wszystkich wpisy sterowników i opisy w kluczu rejestru "Sterowniki ODBC" (lub w sekcji [sterowniki ODBC] Odbcinst.ini).
Aby odszukać keynames i wartości dla lpszAttributes parametr jest źródło danych już skonfigurowane, (prawdopodobnie jeden, który został skonfigurowany przez administratora ODBC) w pliku Odbc.ini.
Aby znaleźć keynames i wartości dla parametru lpszAttributes
Uruchom Edytor rejestru systemu Windows (lub dla 16-bitowego, otwórz plik Odbc.ini).
Znajdowanie informacji źródeł danych ODBC, przy użyciu jednej z następujących czynności:
32-Bitowe na ten temat można znaleźć w kluczu HKEY_CURRENT_USER\Software\ODBC\ODBC.Źródła danych INI\ODBC w lewym okienku.
Prawe okienko zawiera listę wpisów formularza: "pub: REG_SZ:< nazwa źródła danych >", gdzie < nazwa źródła danych > jest źródło danych, który został już skonfigurowany z ustawieniami żądanego sterownika, które mają być używane.Wybierz źródło danych, można na przykład SQL Server.Elementy następującego ciągu znaków "pub:" są w kolejności, keyname i wartość w sieci lpszAttributes parametru.
16-Bitowe, znaleźć sekcji w pliku Odbc.ini, oznaczone < nazwa źródła danych >.
Linie, po tym wierszu mają postać "keyname = wartość".Są one dokładnie wpisów w sieci lpszAttributes parametru.
Można również sprawdzić dokumentację dla określonego sterownika, który zamierzasz użyć.Przydatne informacje można znaleźć w Pomocy online dla sterownika, który można uzyskać dostęp, uruchamiając Administratora ODBC.Te pliki pomocy są zazwyczaj umieszczane w katalogu WINDOWS\SYSTEM dla systemu Windows NT, Windows 3.1 lub Windows 95.
Aby uzyskać pomoc online, aby sterownik ODBC
Uruchom Administratora ODBC.
Kliknij dodać.
Wybierz nazwę sterownika.
Click OK.
Gdy ODBC Administrator Wyświetla informacje dotyczące tworzenia nowego źródła danych dla tego określonego sterownika, kliknij przycisk Pomoc.Spowoduje to otwarcie pliku pomocy dla tego określonego sterownika, który zwykle zawiera ważne informacje dotyczące używania sterownika.