Klasa CDaoQueryDef

Artykuł
02/27/2013

Reprezentuje definicji kwerendy lub "querydef" zwykle jedną zapisane w bazie danych.

class CDaoQueryDef : public CObject

Członkowie

Publiczne konstruktory

Nazwa	Opis
CDaoQueryDef::CDaoQueryDef	Konstrukcje CDaoQueryDef obiektu.Następne wywołanie Otwórz lub Tworzenie, w zależności od potrzeb.

Metody publiczne

Nazwa	Opis
CDaoQueryDef::Append	Obiektu querydef dołącza do kolekcji QueryDefs bazy danych jako zapisanej kwerendy.
CDaoQueryDef::CanUpdate	Zwraca wartość niezerową, jeśli kwerendy można zaktualizować bazy danych.
CDaoQueryDef::Close	Zamknięcie obiektu querydef.Zniszczenie obiektu C++, po zakończeniu z nim.
CDaoQueryDef::Create	Tworzy podstawowej obiektu querydef DAO.Użyj obiektu querydef jako tymczasowe kwerendy lub wywołanie Append go zapisać w bazie danych.
CDaoQueryDef::Execute	Wykonuje kwerendę zdefiniowane przez obiektu querydef.
CDaoQueryDef::GetConnect	Zwraca ciąg połączenia skojarzonych z obiektu querydef.Ciąg połączenia identyfikuje źródło danych.(Dla SQL kwerendy przekazujące tylko; w przeciwnym razie pusty ciąg znaków.)
CDaoQueryDef::GetDateCreated	Zwraca datę utworzenia zapisanej kwerendy.
CDaoQueryDef::GetDateLastUpdated	Zwraca datę ostatniej aktualizacji zapisanej kwerendy.
CDaoQueryDef::GetFieldCount	Zwraca liczbę pól zdefiniowanych przez obiektu querydef.
CDaoQueryDef::GetFieldInfo	Zwraca informacje dotyczące określonego pola zdefiniowane w kwerendzie.
CDaoQueryDef::GetName	Zwraca nazwę obiektu querydef.
CDaoQueryDef::GetODBCTimeout	Zwraca wartość limitu czasu używany przez ODBC (dla kwerendy ODBC) po wykonaniu obiektu querydef.Jak długo określa umożliwić zakończenie działania kwerendy.
CDaoQueryDef::GetParameterCount	Zwraca liczbę parametrów zdefiniowanych dla kwerendy.
CDaoQueryDef::GetParameterInfo	Zwraca informacje dotyczące określonego parametru w kwerendzie.
CDaoQueryDef::GetParamValue	Zwraca wartość określonego parametru w kwerendzie.
CDaoQueryDef::GetRecordsAffected	Zwraca liczbę rekordów dotkniętych kwerendy funkcjonalnej.
CDaoQueryDef::GetReturnsRecords	Zwraca wartość niezerową, jeśli kwerenda określona przez obiektu querydef zwraca rekordy.
CDaoQueryDef::GetSQL	Zwraca ciąg SQL określający kwerendę zdefiniowane przez obiektu querydef.
CDaoQueryDef::GetType	Zwraca typ kwerendy: usuwanie, aktualizacja, dołączająca, tworząca tabelę i tak dalej.
CDaoQueryDef::IsOpen	Zwraca wartość niezerową, jeśli querydef jest otwarty i mogą być wykonywane.
CDaoQueryDef::Open	Otwiera istniejący querydef, przechowywane w bazie danych kolekcji QueryDefs.
CDaoQueryDef::SetConnect	Ustawia ciąg połączenia dla kwerendy przekazującej SQL w źródle danych ODBC.
CDaoQueryDef::SetName	Ustawia nazwę zapisaną kwerendę, zastępując nazwa używana podczas tworzenia obiektu querydef.
CDaoQueryDef::SetODBCTimeout	Ustawia wartość limitu czasu używany przez ODBC (dla kwerendy ODBC) po wykonaniu obiektu querydef.
CDaoQueryDef::SetParamValue	Ustawia wartość parametru określonej kwerendy.
CDaoQueryDef::SetReturnsRecords	Określa, czy obiektu querydef zwraca rekordy.Ustawienie tego atrybutu TRUE jest prawidłowa tylko dla kwerendy przekazujące SQL.
CDaoQueryDef::SetSQL	Ustawia ciąg SQL określający kwerendę zdefiniowane przez obiektu querydef.

Publiczne danych członków

Nazwa	Opis
CDaoQueryDef::m_pDAOQueryDef	Wskaźnik do interfejsu OLE dla podstawowej obiektu querydef DAO.
CDaoQueryDef::m_pDatabase	Wskaźnik do CDaoDatabase obiektu, z którym jest skojarzone obiektu querydef.Obiektu querydef może być zapisany w bazie danych lub nie.

Uwagi

Querydef jest obiekt dostępu do danych zawiera instrukcję SQL opisującą kwerendę i jego właściwości "Data utworzenia" i "Limit czasu ODBC." Można również utworzyć tymczasowy querydef obiektów bez ich zapisywania, ale jest to wygodne — i bardziej efektywna — najczęściej zapisać ponownie kwerend w bazie danych.A CDaoDatabase obiekt zachowuje kolekcji o nazwie kolekcji QueryDefs, zawierający jego zapisane querydefs.

[!UWAGA]

Klasy bazy danych DAO różnią się od klasy bazy danych MFC oparte na Open Database Connectivity (ODBC).Wszystkie nazwy klasy bazy danych DAO mają prefiks "CDao".Możesz nadal dostęp do źródeł danych ODBC z klas obiektów DAO.Ogólnie rzecz biorąc klas MFC oparte na DAO nadają więcej niż klas MFC oparte na ODBC; podstawie DAO klasy można uzyskać dostęp do danych, w tym poprzez sterowniki ODBC, poprzez własne aparatu bazy danych.Klas opartych na DAO obsługuje także operacje języka definicji danych (DDL), takie jak dodawanie tabel za pośrednictwem klas, bez konieczności bezpośrednio wywołać DAO.

Sposób użycia

Używać obiektów querydef pracować z istniejącymi zapisanej kwerendy lub utworzyć nową zapisywane tymczasowe lub kwerendy:

We wszystkich przypadkach pierwsze skonstruować CDaoQueryDef obiektu dostarczanie wskaźnik do CDaoDatabase obiektu, do którego należy kwerendy.
Następnie wykonaj poniższe czynności, w zależności od tego, co chcesz:
- Aby korzystać z istniejącą zapisaną kwerendę, wywołanie obiektu querydef Otwórz funkcji składowej, podanie nazwy zapisanej kwerendy.
- Aby utworzyć nową zapisaną kwerendę, wywołanie obiektu querydef Tworzenie funkcji składowej, podanie nazwy kwerendy.Następnie wywołać Append zapisać kwerendy przez dołączenie jej do kolekcji QueryDefs bazy danych.Tworzenie powoduje umieszczenie obiektu querydef w stanie otwartym, tak po wywołaniu Tworzenie nie wymagają Otwórz.
- Aby utworzyć tymczasowy querydef, wywołać Tworzenie.Przekazać pusty ciąg nazwy kwerendy.Nie wywołuj Append.

Po zakończeniu za pomocą obiektu querydef wywołanie jego Zamknij Członkowskich funkcji; następnie zniszczenie obiektu querydef.

Porada
Najprostszym sposobem utworzenia zapisane kwerendy jest ich tworzenie i przechowywanie ich w bazie danych przy użyciu programu Microsoft Access.Następnie można otworzyć i używać ich w kodzie MFC.

Celów

Można użyć obiektu querydef dla dowolnego z następujących celów:

Aby utworzyć CDaoRecordset obiektu
Wywołanie obiektu Execute Członkowskich funkcji bezpośrednio wykonanie kwerendy funkcjonalnej lub kwerendy przekazującej SQL

Można użyć obiektu querydef dla dowolnego typu kwerendy, łącznie z select, działania, krzyżowej, Usuń, aktualizacja, dołączająca, tworząca, definicja danych, przekazujące SQL, Unii i masowych kwerend.Typ kwerendy zależy od zawartości instrukcji SQL należy.Informacje dotyczące typów kwerend, zobacz Execute i GetType funkcji elementów członkowskich.Zestawy rekordów są często używane do zwracania wiersz kwerendy, zwykle na tych SELECT... Z słowa kluczowe.Wykonanie jest najczęściej używane dla operacji zbiorczych.Aby uzyskać więcej informacji, zobacz Execute i CDaoRecordset.

Querydefs i zestawy rekordów

Aby użyć do utworzenia obiektu querydef CDaoRecordset obiektu zwykle utworzyć lub otworzyć querydef, jak opisano powyżej.Następnie konstruowania obiektu recordset, przekazując wskaźnik do obiektu querydef podczas wywołania CDaoRecordset::Open.Przekazywany obiektu querydef musi być w stanie otwartym.Aby uzyskać więcej informacji, zobacz klasy CDaoRecordset.

Za pomocą querydef nie można utworzyć zestaw rekordów (najczęściej używane querydef), chyba że jest w stanie otwartym.Umieszczanie obiektu querydef w stanie otwartym wywołując albo Otwórz lub Tworzenie.

Zewnętrznych baz danych

Obiekty QueryDef są preferowanym sposobem użycia macierzystego SQL dialekt silnika zewnętrznej bazy danych.Można na przykład utworzyć kwerendę Transact SQL (jak w Microsoft SQL Server) i przechowywać go w obiektu querydef.Należy użyć kwerendy SQL nie są oparte na aparatu bazy danych Microsoft Jet, podanie ciągu połączenia, który wskazuje źródło danych zewnętrznych.Kwerendy zawierające ciągi prawidłowe połączenie pomijanie aparatu bazy danych i przekazywać kwerendy bezpośrednio do serwera bazy danych zewnętrznych dla przetwarzania.