CDaoQueryDefInfo — Struktura

Struktura CDaoQueryDefInfo zawiera informacje o obiekcie querydef zdefiniowanym dla obiektów dostępu do danych (DAO).

Uwaga

Obiekt dostępu do danych (DAO) jest obsługiwany za pośrednictwem pakietu Office 2013. DaO 3.6 jest wersją ostateczną i jest przestarzała.

Składnia

struct CDaoQueryDefInfo
{
    CString m_strName;               // Primary
    short m_nType;   // Primary
    COleDateTime m_dateCreated;      // Secondary
    COleDateTime m_dateLastUpdated;  // Secondary
    BOOL m_bUpdatable;               // Secondary
    BOOL m_bReturnsRecords;          // Secondary
    CString m_strSQL;                // All
    CString m_strConnect;            // All
    short m_nODBCTimeout;            // All
};

Parametry

m_strName
Unikatowe nazwy obiektu querydef. Aby uzyskać więcej informacji, zobacz temat "Name Property" (Nazwa właściwości) w pomocy dao. Wywołaj metodę CDaoQueryDef::GetName , aby pobrać tę właściwość bezpośrednio.

m_nType
Wartość wskazująca typ operacyjny obiektu querydef. Wartość może być jedną z następujących wartości:

• dbQSelect Wybierz: zapytanie wybiera rekordy.

• dbQAction Akcja: zapytanie przenosi lub zmienia dane, ale nie zwraca rekordów.

• dbQCrosstab Krzyżowe: zapytanie zwraca dane w formacie przypominającym arkusz kalkulacyjny.

• dbQDelete Usuń: zapytanie usuwa zestaw określonych wierszy.

• dbQUpdate Aktualizacja: zapytanie zmienia zestaw rekordów.

• dbQAppend Dołączanie: zapytanie dodaje nowe rekordy na końcu tabeli lub zapytania.

• dbQMakeTable Utwórz tabelę: zapytanie tworzy nową tabelę na podstawie zestawu rekordów.

• dbQDDL Definicja danych: zapytanie wpływa na strukturę tabel lub ich części.

• dbQSQLPassThrough Przekazywanie: instrukcja SQL jest przekazywana bezpośrednio do zaplecza bazy danych bez przetwarzania pośredniego.

• dbQSetOperation Unia: zapytanie tworzy obiekt zestawu rekordów typu migawki zawierający dane ze wszystkich określonych rekordów w co najmniej dwóch tabelach z usuniętymi zduplikowanymi rekordami. Aby uwzględnić duplikaty, dodaj słowo kluczowe ALL w instrukcji SQL elementu querydef.

• dbQSPTBulkdbQSQLPassThrough Służy do określania zapytania, które nie zwraca rekordów.

Uwaga

Aby utworzyć zapytanie przekazywane SQL, nie ustawiasz stałej dbQSQLPassThrough . Jest on ustawiany automatycznie przez aparat bazy danych Microsoft Jet podczas tworzenia obiektu querydef i ustawiania Connect właściwości.

Aby uzyskać więcej informacji, zobacz temat "Typ właściwości" w pomocy dao.

m_dateCreated
Data i godzina utworzenia definicji zapytania. Aby bezpośrednio pobrać datę utworzenia definicji zapytania, wywołaj funkcję CDaoTableDef składową GetDateCreated obiektu skojarzonego z tabelą. Aby uzyskać więcej informacji, zobacz Uwagi. Zobacz również temat "DateCreated, LastUpdated Properties" w Pomocy dao.

m_dateLastUpdated
Data i godzina ostatniej zmiany wprowadzonej w definicji zapytania. Aby bezpośrednio pobrać datę ostatniej aktualizacji tabeli, wywołaj funkcję składową GetDateLastUpdated definicji zapytania. Aby uzyskać więcej informacji, zobacz Uwagi. Zobacz również temat "DateCreated, LastUpdated Properties" w Pomocy dao.

m_bUpdatable
Wskazuje, czy zmiany można wprowadzić w obiekcie querydef. Jeśli ta właściwość ma wartość TRUE, definicję kwerendy można zaktualizować; w przeciwnym razie nie jest. Możliwość aktualizowania oznacza, że można zmienić definicję zapytania obiektu querydef. Właściwość Updatable obiektu querydef jest ustawiona na wartość TRUE, jeśli można zaktualizować definicję zapytania, nawet jeśli wynikowy zestaw rekordów nie jest aktualizowalny. Aby pobrać tę właściwość bezpośrednio, wywołaj funkcję składową CanUpdate elementu członkowskiego querydef. Aby uzyskać więcej informacji, zobacz temat "Updatable Property" (Updatable Property) w pomocy dotyczącej języka DAO.

m_bReturnsRecords
Wskazuje, czy zapytanie przekazywane SQL do zewnętrznej bazy danych zwraca rekordy. Jeśli ta właściwość ma wartość TRUE, zapytanie zwraca rekordy. Aby bezpośrednio pobrać tę właściwość, wywołaj metodę CDaoQueryDef::GetReturnsRecords. Nie wszystkie zapytania przekazywane SQL do zewnętrznych baz danych zwracają rekordy. Na przykład instrukcja SQL UPDATE aktualizuje rekordy bez zwracania rekordów, podczas gdy instrukcja SQL SELECT zwraca rekordy. Aby uzyskać więcej informacji, zobacz temat "ReturnsRecords Property" (Właściwość ReturnsRecords) w pomocy języka DAO.

m_strSQL
Instrukcja SQL, która definiuje zapytanie wykonywane przez obiekt querydef. Właściwość SQL zawiera instrukcję SQL, która określa sposób wybierania, grupowania i porządkowanego rekordów podczas wykonywania zapytania. Możesz użyć zapytania, aby wybrać rekordy do uwzględnienia w obiekcie zestawu rekordów typu dynaset lub migawki. Zapytania zbiorcze można również definiować w celu modyfikowania danych bez zwracania rekordów. Wartość tej właściwości można pobrać bezpośrednio, wywołując funkcję składową GetSQL metody querydef.

m_strConnect
Zawiera informacje o źródle bazy danych używanej w zapytaniu przekazywanym. Te informacje mają postać parametrów połączenia. Aby uzyskać więcej informacji na temat ciągów łączenia i uzyskać informacje na temat pobierania wartości tej właściwości bezpośrednio, zobacz funkcję składową CDaoDatabase::GetConnect .

m_nODBCTimeout
Liczba sekund oczekiwania aparatu bazy danych Microsoft Jet przed wystąpieniem błędu przekroczenia limitu czasu w przypadku uruchomienia zapytania w bazie danych Open Database Connectivity (ODBC). W przypadku korzystania z bazy danych ODBC, takiej jak program Microsoft SQL Server, mogą wystąpić opóźnienia z powodu ruchu sieciowego lub dużego użycia serwera ODBC. Zamiast czekać na czas nieokreślony, możesz określić czas oczekiwania aparatu Microsoft Jet przed wystąpieniem błędu. Domyślna wartość limitu czasu to 60 sekund. Wartość tej właściwości można pobrać bezpośrednio, wywołując funkcję składową GetODBCTimeout elementu querydef. Aby uzyskać więcej informacji, zobacz temat "ODBCTimeout Property" (Właściwość ODBCTimeout) w pomocy języka DAO.

Uwagi

Querydef jest obiektem klasy CDaoQueryDef. Odwołania do podstawowej, pomocniczej i wszystkich wskazują, jak informacje są zwracane przez funkcję składową GetQueryDefInfo w klasie CDaoDatabase.

Informacje pobierane przez funkcję składową CDaoDatabase::GetQueryDefInfo są przechowywane w CDaoQueryDefInfo strukturze. Wywołaj GetQueryDefInfo obiekt bazy danych w kolekcji QueryDefs, w którym jest przechowywany obiekt querydef. CDaoQueryDefInfo Definiuje również funkcję składową Dump w kompilacjach debugowania. Możesz użyć Dump polecenia , aby zrzucić zawartość CDaoQueryDefInfo obiektu. Klasa CDaoDatabase dostarcza również funkcje składowe umożliwiające bezpośredni dostęp do wszystkich właściwości zwracanych w obiekcie, więc rzadko wywołujesz metodę CDaoQueryDefInfo GetQueryDefInfo.

Po dołączeniu nowego pola lub obiektu parametru do kolekcji Pola lub Parametry obiektu querydef zostanie zgłoszony wyjątek, jeśli bazowa baza danych nie obsługuje typu danych określonego dla nowego obiektu.

Ustawienia daty i godziny pochodzą z komputera, na którym utworzono lub ostatnio zaktualizowano definicję zapytań. W środowisku wieloużytkowników użytkownicy powinni uzyskać te ustawienia bezpośrednio z serwera plików przy użyciu polecenia net time , aby uniknąć rozbieżności w ustawieniach właściwości DateCreated i LastUpdated.

Wymagania

Nagłówek: afxdao.h

Zobacz też

Struktury, style, wywołania zwrotne i mapy komunikatów
Klasa CDaoQueryDef
Klasa CDaoDatabase