CDaoQueryDefInfo Yapısı

Yapı, CDaoQueryDefInfo veri erişim nesneleri (DAO) için tanımlanan bir sorgu tanımı nesnesi hakkında bilgi içerir.

Not

Veri Erişim Nesnesi (DAO), Office 2013 aracılığıyla desteklenir. DAO 3.6 son sürümdür ve kullanımdan kaldırılmış durumdadır.

Sözdizimi

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
};

Parametreler

m_strName
Querydef nesnesini benzersiz olarak adlandırın. Daha fazla bilgi için DAO Yardımı'ndaki "Ad Özelliği" konusuna bakın. Bu özelliği doğrudan almak için CDaoQueryDef::GetName öğesini çağırın.

m_nType
Sorgu tanımı nesnesinin işlem türünü gösteren değer. Değer aşağıdakilerden biri olabilir:

• dbQSelect Seçin: sorgu kayıtları seçer.

• dbQAction Eylem: Sorgu verileri taşır veya değiştirir ancak kayıtları döndürmez.

• dbQCrosstab Çapraz: Sorgu verileri elektronik tablo benzeri bir biçimde döndürür.

• dbQDelete Sil: sorgu, belirtilen satır kümesini siler.

• dbQUpdate Güncelleştirme: Sorgu bir kayıt kümesini değiştirir.

• dbQAppend Ekleme: Sorgu, bir tablo veya sorgunun sonuna yeni kayıtlar ekler.

• dbQMakeTable Tablo yapma: Sorgu, kayıt kümesinden yeni bir tablo oluşturur.

• dbQDDL Veri tanımı: Sorgu, tabloların yapısını veya bölümlerini etkiler.

• dbQSQLPassThrough Geçiş: SQL deyimi, ara işleme olmadan doğrudan veritabanı arka ucuna geçirilir.

• dbQSetOperation Birleşim: Sorgu, yinelenen kayıtların kaldırıldığı iki veya daha fazla tablodaki tüm belirtilen kayıtlardan verileri içeren bir anlık görüntü türü kayıt kümesi nesnesi oluşturur. Yinelenenleri eklemek için, querydef'in SQL deyimine ALL anahtar sözcüğünü ekleyin.

• dbQSPTBulk ile, dbQSQLPassThrough kayıtları döndürmeyen bir sorgu belirtmek için kullanılır.

Not

SQL geçiş sorgusu oluşturmak için sabitini dbQSQLPassThrough ayarlamazsınız. Bu, bir sorgu tanımı nesnesi oluşturduğunuzda ve özelliğini ayarladığınızda Connect Microsoft Jet veritabanı altyapısı tarafından otomatik olarak ayarlanır.

Daha fazla bilgi için DAO Yardımı'ndaki "Tür Özelliği" konusuna bakın.

m_dateCreated
Sorgu tanımı oluşturulduğu tarih ve saat. Sorgu tanımı oluşturulduğu tarihi doğrudan almak için tabloyla ilişkili nesnenin CDaoTableDef GetDateCreated üye işlevini çağırın. Daha fazla bilgi için bkz . Açıklamalar. Ayrıca DAO Yardımı'nda "DateCreated, LastUpdated Properties" konusuna da bakın.

m_dateLastUpdated
Sorgu tanımında yapılan en son değişikliğin tarihi ve saati. Tablonun son güncelleştirildiği tarihi doğrudan almak için querydef'in GetDateLastUpdated üye işlevini çağırın. Daha fazla bilgi için bkz . Açıklamalar. Ayrıca DAO Yardımı'nda "DateCreated, LastUpdated Properties" konusuna da bakın.

m_bUpdatable
Sorgu tanımı nesnesinde değişiklik yapılıp yapılamayacağını gösterir. Bu özellik TRUE ise sorgu tanımı güncelleştirilebilir; aksi takdirde, değildir. Güncelleştirilebilir, sorgu tanımı nesnesinin sorgu tanımının değiştirilebileceği anlamına gelir. Sorgu tanımı güncelleştirilebiliyorsa, sonuçta elde edilen kayıt kümesi güncelleştirilemez olsa bile bir sorgu tanımı nesnesinin Updatable özelliği TRUE olarak ayarlanır. Bu özelliği doğrudan almak için querydef'in CanUpdate üye işlevini çağırın. Daha fazla bilgi için DAO Yardımı'ndaki "Güncelleştirilebilir Özellik" konusuna bakın.

m_bReturnsRecords
Dış veritabanına yapılan SQL geçiş sorgusunda kayıtların döndürülip döndürülmeyeceğini gösterir. Bu özellik TRUE ise, sorgu kayıtları döndürür. Bu özelliği doğrudan almak için CDaoQueryDef::GetReturnsRecords çağrısında bulunur. Dış veritabanlarına yapılan tüm SQL geçiş sorguları kayıtları döndürmez. Örneğin, SQL UPDATE deyimi kayıtları döndürmeden kayıtları güncelleştirirken, SQL SELECT deyimi kayıtları döndürür. Daha fazla bilgi için DAO Yardımı'ndaki "ReturnsRecords Özelliği" konusuna bakın.

m_strSQL
Bir sorgu tanımı nesnesi tarafından yürütülen sorguyu tanımlayan SQL deyimi. SQL özelliği, sorguyu yürütürken kayıtların nasıl seçileceğini, gruplandırıldığını ve sıralandığını belirleyen SQL deyimini içerir. Dinamik küme veya anlık görüntü türündeki kayıt kümesi nesnesine eklenecek kayıtları seçmek için sorguyu kullanabilirsiniz. Ayrıca, kayıtları döndürmeden verileri değiştirmek için toplu sorgular tanımlayabilirsiniz. Querydef'in GetSQL üye işlevini çağırarak bu özelliğin değerini doğrudan alabilirsiniz.

m_strConnect
Doğrudan sorguda kullanılan bir veritabanının kaynağı hakkında bilgi sağlar. Bu bilgiler bir bağlantı dizesi biçimindedir. Dizeleri bağlama hakkında daha fazla bilgi edinmek ve bu özelliğin değerini doğrudan alma hakkında bilgi için bkz . CDaoDatabase::GetConnect üye işlevi.

m_nODBCTimeout
Açık Veritabanı Bağlantısı (ODBC) veritabanında sorgu çalıştırıldığında Microsoft Jet veritabanı altyapısının zaman aşımı hatası oluşmadan önce bekleyeceği saniye sayısı. Microsoft SQL Server gibi bir ODBC veritabanı kullanırken, ağ trafiği veya ODBC sunucusunun yoğun kullanımı nedeniyle gecikmeler olabilir. Süresiz beklemek yerine, Microsoft Jet altyapısının hata üretmeden önce ne kadar bekleyeceğini belirtebilirsiniz. Varsayılan zaman aşımı değeri 60 saniyedir. Querydef'in GetODBCTimeout üye işlevini çağırarak bu özelliğin değerini doğrudan alabilirsiniz. Daha fazla bilgi için DAO Yardımı'ndaki "ODBCTimeout Özelliği" konusuna bakın.

Açıklamalar

Querydef, CDaoQueryDef sınıfının bir nesnesidir. Primary, Secondary ve All başvuruları, sınıftaki CDaoDatabaseGetQueryDefInfo üye işlevi tarafından bilgilerin nasıl döndürüldiğini gösterir.

CDaoDatabase::GetQueryDefInfo üye işlevi tarafından alınan bilgiler bir CDaoQueryDefInfo yapıda depolanır. QueryDefs koleksiyonunun querydef nesnesinin depolandığı veritabanı nesnesini çağırın GetQueryDefInfo . CDaoQueryDefInfo ayrıca hata ayıklama derlemelerinde bir Dump üye işlevi tanımlar. Bir CDaoQueryDefInfo nesnenin içeriğini dökümü için kullanabilirsinizDump. Sınıfı CDaoDatabase ayrıca bir CDaoQueryDefInfo nesnede döndürülen tüm özelliklere doğrudan erişmek için üye işlevleri sağlar, bu nedenle nadiren çağrırsınız GetQueryDefInfo.

Sorgu tanımı nesnesinin Fields veya Parameters koleksiyonuna yeni bir alan veya parametre nesnesi eklediğinizde, temel alınan veritabanı yeni nesne için belirtilen veri türünü desteklemiyorsa bir özel durum oluşturulur.

Tarih ve saat ayarları, sorgu tanımı oluşturulduğu veya son güncelleştirildiği bilgisayardan türetilir. Çok kullanıcılı bir ortamda, kullanıcıların DateCreated ve LastUpdated özellik ayarlarındaki tutarsızlıkları önlemek için net time komutunu kullanarak bu ayarları doğrudan dosya sunucusundan alması gerekir.

Gereksinimler

Üstbilgi: afxdao.h

Ayrıca bkz.

Yapılar, Stiller, Geri Çağrılar ve İleti Eşlemeleri
CDaoQueryDef Sınıfı
CDaoDatabase Sınıfı