CDaoFieldInfo – struktura
CDaoFieldInfo Struktura obsahuje informace o objektu pole definované pro objekty aplikace access data (DAO).
struct CDaoFieldInfo
{
CString m_strName; // Primary
short m_nType; // Primary
long m_lSize; // Primary
long m_lAttributes; // Primary
short m_nOrdinalPosition; // Secondary
BOOL m_bRequired; // Secondary
BOOL m_bAllowZeroLength; // Secondary
long m_lCollatingOrder; // Secondary
CString m_strForeignName; // Secondary
CString m_strSourceField; // Secondary
CString m_strSourceTable; // Secondary
CString m_strValidationRule; // All
CString m_strValidationText; // All
CString m_strDefaultValue; // All
};
Parametry
m_strName
Jednoznačně název objektu field.Další informace naleznete v tématu "Název vlastnosti" v nápovědě rozhraní DAO.m_nType
Hodnota, která určuje typ dat pole.Podrobné informace naleznete v tématu "Vlastnost typu" v nápovědě rozhraní DAO.Hodnota této vlastnosti může být jeden z následujících kroků:dbBoolean Ano/Ne, stejné jako TRUE/FALSE
dbByte Byte
dbInteger krátké
dbLong dlouhý
dbCurrency měně; třídy MFC viz COleCurrency
dbSingle jeden
dbDouble dvojitý
dbDate datum a čas; třídy MFC viz COleDateTime
dbText textu; třídy MFC viz CString
dbLongBinary dlouhá binární data (objekt OLE); můžete použít třídu knihovny MFC CByteArray namísto třídy CLongBinary jako CByteArray je lepší a snadnější použití.
dbMemo penále; viz třída knihovny MFCCString
dbGUID A globálně jedinečný identifikátor či univerzálně jedinečný identifikátor používaný při vzdáleném volání procedur.Další informace naleznete v tématu "Vlastnost typu" v nápovědě rozhraní DAO.
[!POZNÁMKA]
Nepoužívejte pro binární data datové typy string.To způsobí, že data přes vrstvu překladu Unicode/ANSI, následkem zvýšené nároky a případně neočekávané překlad.
m_lSize
Hodnota, která určuje maximální velikost v bajtech pole objektu DAO, který obsahuje text nebo pevnou velikost pole objektu, který obsahuje textové nebo číselné hodnoty.Další informace naleznete v tématu "Vlastnost Size" v nápovědě rozhraní DAO.Velikost může být jeden z následujících hodnot:Typ
Velikost (bajty)
Popis
dbBoolean
1 bajt
Ano (stejně jako True/False)
dbByte
1
Byte
dbInteger
2
Integer
dbLong
4
Dlouhá
dbCurrency
8
Měna (COleCurrency)
dbSingle
4
Jednoduché
dbDouble
8
Double
dbDate
8
Datum a čas (COleDateTime)
dbText
1 - 255
Text (CString)
dbLongBinary
0
Dlouhá binární (objekt OLE; CByteArray; použít místo CLongBinary)
dbMemo
0
Memo (CString)
dbGUID
16
Globálně jedinečný identifikátor či univerzálně jedinečný identifikátor používaný při vzdáleném volání procedur.
m_lAttributes
Určuje vlastnosti obsažené tabledef, sady záznamů, querydef nebo objekt index pole objektu.Vrácená hodnota může být součet těchto konstant, vytvořené pomocí (bitový operátor OR C++|) operátor:dbFixedField velikost pole je pevná (výchozí nastavení pro číselná pole).
dbVariableField velikost pole je proměnná (pouze pro textová pole).
dbAutoIncrField na jedinečný dlouhé celé číslo, které nelze změnit, se automaticky zvyšuje hodnotu pole pro nové záznamy.Podporováno pouze pro tabulky databáze Microsoft Jet.
dbUpdatableField hodnotu tohoto pole lze změnit.
dbDescending pole seřazena sestupně (Z - A nebo 100-0) objednávky (platí pouze pro pole objektu v kolekci Fields objektu index; v knihovně MFC, index objekty jsou samy součástí objekty tabledef).Vynecháte-li tato konstanta, je pole seřazeném vzestupně (A - Z nebo 0 - 100) objednávky (výchozí).
Při kontrole nastavení této vlastnosti, můžete použít C++ bitové- a operátor (&) k testování pro určitý atribut.Nastavujete-li více atributů, můžete je spojit kombinací příslušné konstanty s (bitový operátor OR**|**) operátor.Další informace naleznete v tématu "Vlastnosti Attributes" v nápovědě rozhraní DAO.
m_nOrdinalPosition
Hodnota, která určuje číselného pořadí, ve kterém chcete pole reprezentované objektu DAO pole mají být zobrazeny ve vztahu k ostatní pole.Můžete nastavit tuto vlastnost s vlastností CDaoTableDef::CreateField.Podrobné informace naleznete v tématu "Vlastnost OrdinalPosition" v nápovědě rozhraní DAO.m_bRequired
Určuje, zda pole objektu DAO vyžaduje nenulovou hodnotu.Pokud je tato vlastnost TRUE, pole nemůže obsahovat hodnotu Null.V případě potřeby je nastavena na FALSE, může pole obsahovat hodnoty Null, stejně jako hodnoty, které vyhovují podmínkám určeným nastavením vlastností Povolit nulovou délku a ověřovací pravidlo.Další informace naleznete v tématu "Vlastnost je nutno zadat" v nápovědě rozhraní DAO.Můžete nastavit tuto vlastnost pro tabledef s CDaoTableDef::CreateField.m_bAllowZeroLength
Označuje, zda je prázdný řetězec ("") je platná hodnota pole objektu DAO s datovým typem Text nebo Memo.Pokud je tato vlastnost TRUE, platná hodnota je prázdný řetězec.Tuto vlastnost lze nastavit FALSE zajistit, že prázdný řetězec nelze použít k nastavení hodnoty pole.Další informace naleznete v tématu "Vlastnost Povolit nulovou délku" v nápovědě rozhraní DAO.Můžete nastavit tuto vlastnost pro tabledef s CDaoTableDef::CreateField.m_lCollatingOrder
Určuje pořadí řazení v textu pro porovnání řetězců nebo řazení.Další informace naleznete v tématu "Přizpůsobení systému Windows registru nastavení pro přístup k datům" v nápovědě rozhraní DAO.Seznam možných hodnot vrácených naleznete m_lCollatingOrder člen CDaoDatabaseInfo struktury.Můžete nastavit tuto vlastnost pro tabledef s CDaoTableDef::CreateField.m_strForeignName
Hodnota, která ve vztahu, určuje název objektu field objektu DAO v cizí tabulce odpovídající pole v primární tabulce.Další informace naleznete v tématu "Vlastnost ForeignName" v nápovědě rozhraní DAO.m_strSourceField
Označuje název pole, které je původní zdroj dat pole objektu DAO tabledef, sady záznamů nebo objektu querydef obsažené.Tato vlastnost označuje název původní pole přidružené k objektu pole.Například můžete použít tuto vlastnost k určení původního zdroje dat v dotazu pole, jehož název nezávislým na název pole v podkladové tabulce.Další informace naleznete v tématu "SourceField vlastnosti SourceTable" v nápovědě rozhraní DAO.Můžete nastavit tuto vlastnost pro tabledef s CDaoTableDef::CreateField.m_strSourceTable
Určuje název tabulky, která je původní zdroj dat pole objektu DAO tabledef, sady záznamů nebo objektu querydef obsažené.Tato vlastnost označuje původní název tabulky přidružené pole objektu.Například můžete použít tuto vlastnost k určení původního zdroje dat v dotazu pole, jehož název nezávislým na název pole v podkladové tabulce.Další informace naleznete v tématu "SourceField vlastnosti SourceTable" v nápovědě rozhraní DAO.Můžete nastavit tuto vlastnost pro tabledef s CDaoTableDef::CreateField.m_strValidationRule
Hodnota, která ověří data v poli je změněn nebo přidán do tabulky.Další informace naleznete v tématu "Vlastnost ověřovací pravidlo" v nápovědě rozhraní DAO.Můžete nastavit tuto vlastnost pro tabledef s CDaoTableDef::CreateField.Související informace o tabledefs naleznete m_strValidationRule člen CDaoTableDefInfo struktury.
m_strValidationText
Hodnota, která určuje text zprávy, která aplikace se zobrazí, jestliže hodnota pole objektu DAO nesplňuje pravidlo ověření určené nastavením vlastnosti Ověřovací pravidlo.Další informace naleznete v tématu "Vlastnost Ověřovací text" v nápovědě rozhraní DAO.Můžete nastavit tuto vlastnost pro tabledef s CDaoTableDef::CreateField.m_strDefaultValue
Výchozí hodnota pole objektu DAO.Když je vytvořen nový záznam, nastavení vlastnosti výchozí hodnota automaticky zadána jako hodnota pro pole.Další informace naleznete v tématu "Vlastnost Výchozí hodnota" v nápovědě rozhraní DAO.Můžete nastavit tuto vlastnost pro tabledef s CDaoTableDef::CreateField.
Poznámky
Odkazy na primární, sekundární a všechny výše uvedené označení, jak je informace vrácena GetFieldInfo členské funkce tříd CDaoTableDef, CDaoQueryDef, a CDaoRecordset.
Pole objekty nejsou reprezentovány pomocí třídy knihovny MFC.Místo toho obsahují základní objekty následujících tříd knihovny MFC rozhraní DAO objekty kolekce pole objektů: CDaoTableDef, CDaoRecordset, a CDaoQueryDef.Tyto třídy poskytnou členské funkce pro přístup k některé jednotlivé položky informací o poli nebo je všechny najednou s CDaoFieldInfo objekt voláním GetFieldInfo členské funkce objektu obsahující.
Kromě jeho použití k posouzení vlastností objektu, můžete také použít CDaoFieldInfo k vytvoření vstupní parametr pro vytvoření nových polí tabledef.Jednodušší možnosti jsou k dispozici pro tento úkol, ale pokud chcete mít lepší kontrolu, můžete použít verzi CDaoTableDef::CreateField , která má CDaoFieldInfo parametr.
Informace získané podle GetFieldInfo členské funkce (třídy, která obsahuje pole) jsou uloženy v CDaoFieldInfo struktury.Volat GetFieldInfo členské funkce obsahující objekt, v jehož kolekce pole je pole objekt uložen.CDaoFieldInfoDefinuje také Dump členské funkce v ladění sestavení.Můžete použít Dump pro výpis obsahu CDaoFieldInfo objektu.
Požadavky
Záhlaví: afxdao.h