Поделиться через


Структура CDaoFieldInfo

Структура CDaoFieldInfo содержит сведения о конкретном объекте поля (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 
};

Параметры

  • m_strName
    Уникальные имена объект поля. Дополнительные сведения см. в разделе «свойство» Имя» в справке DAO.

  • m_nType
    Значение, которое указывает тип данных поля. Дополнительные сведения см. в разделе «свойство типа» в справке DAO. Значение этого свойства может быть одним из следующих:

    • dbBoolean Yes/No, то же, что и TRUE/ЛОЖЬ

    • байт dbByte

    • dbInteger короткое

    • dbLong -

    • валюта dbCurrency; см. класс MFC COleCurrency.

    • dbSingle одно

    • double dbDouble

    • дата и время dbDate; см. класс MFC COleDateTime.

    • текст dbText; см. класс MFC CString.

    • бинарный dbLongBinary объект OLE (long); может потребоваться использовать класс MFC CByteArray вместо класса CLongBinary как CByteArray более богато и являются простыми в использовании.

    • Memo dbMemo; см. в описании класса CString MFC

    • dbGUID глобальный уникальный идентификатор ( UUID используется с удаленными вызовами процедур (RPC). Дополнительные сведения см. в разделе «свойство типа» в справке DAO.

    Примечание

    Не используйте строковые типы данных для двоичных данных.Это приводит к тому, что данные можно передавать на уровне преобразования Юникода Или ANSI, приведет к увеличенной рабочей нагрузки и по возможности непредвиденном перемещении.

  • m_lSize
    Значение, указывающее максимальный размер в байтах для объекта DAO поля, содержащего текст или фиксированный размер объекта поля, содержащего текст или числовые значения. Дополнительные сведения см. в разделе «свойство размера» в справке DAO. Размеры могут иметь одно из следующих значений:

    Тип

    Размер (в байтах)

    Описание

    dbBoolean

    1 байт

    Yes/No (аналогично true или false)

    dbByte

    1

    Byte

    dbInteger

    2

    Целое

    dbLong

    4

    Long

    dbCurrency

    8

    Валюта (COleCurrency)

    dbSingle

    4

    Single

    dbDouble

    8

    Double

    dbDate

    8

    Даты и времени (COleDateTime)

    dbText

    1 - 255

    Текст (CString)

    dbLongBinary

    0

    Long бинарный (OLE объект; CByteArray; использовать вместо CLongBinary)

    dbMemo

    0

    Memo (CString)

    dbGUID

    16

    Глобальный уникальный идентификатор ( UUID используется с удаленными вызовами процедур (RPC).

  • m_lAttributes
    Определяет характеристики объекта поля, содержащего tabledef, набором записей, QueryDef или объектом индекса. Возвращенное значение может быть суммой этих констант, созданной с C++ bitwise- ИЛИ ( |) оператор.

    • dbFixedField размер поля фиксировано (по умолчанию для числовых полей).

    • dbVariableField размер поля переменным (только текстовые поля).

    • dbAutoIncrField значения поля для новых записей автоматически увеличивается на однозначно длинному целое число, которое нельзя изменить. Поддерживается только для таблиц базы данных Microsoft Jet.

    • dbUpdatableField значения полей можно изменить.

    • поле dbDescending сортируется в спуская (a — Z или от 100 до 0) порядке (применяется только к объекту поля в коллекции полей объекта индекс. в MFC, объекты сами индекса содержащиеся в объектах tabledef). Если пропустить эту константу, сортируется в поле восходя (a-z или от 0 до 100) порядке (по умолчанию).

    Проверка параметр этого свойства, можно использовать оператор побитового C И C++ (&) для заданного атрибута. Параметр несколько атрибутов, можно объедините их путем объединения соответствующие константы с bitwise- ИЛИ ( **|**оператор). Дополнительные сведения см. в разделе «свойство атрибутов» в справке DAO.

  • m_nOrdinalPosition
    Значение, указывающее числовой порядок, в котором нужно представить поле объектом поля DAO, отображаемый относительно других полей. Можно задать это свойство с помощью CDaoTableDef::CreateField. Дополнительные сведения см. в разделе «свойство OrdinalPosition» в справке DAO.

  • m_bRequired
    Указывает, требуется ли объект поля DAO значение, отличное от NULL. Если это свойство имеет значение TRUE, то поле не допускает значение NULL. При необходимости установлено значение ЛОЖЬ, поле может содержать значения NULL, так и значения, которые соответствуют условиям, параметрами свойств AllowZeroLength и ValidationRule. Дополнительные сведения см. в разделе «свойства которого» в справке DAO. Можно задать это свойство для tabledef с CDaoTableDef::CreateField.

  • m_bAllowZeroLength
    Указывает, является ли пустая строка ("") допустимое значение объекта DAO поля с типом данных текста или Memo. Если это свойство имеет значение TRUE, то пустая строка является допустимым значением. Можно установить это свойство в значение ЛОЖЬ, чтобы убедиться, что невозможно использовать пустую строку задать значение поля. Дополнительные сведения см. в разделе «свойство AllowZeroLength» в справке DAO. Можно задать это свойство для tabledef с CDaoTableDef::CreateField.

  • m_lCollatingOrder
    Определяет последовательность порядка сортировки в текст для сравнения строк или сортировки. Дополнительные сведения см. в разделе «настраивать параметры реестра Windows для доступа к данным» в справке DAO. Для списка возможные значения возвращаются член структуры m_lCollatingOrder см. в разделе CDaoDatabaseInfo. Можно задать это свойство для tabledef с CDaoTableDef::CreateField.

  • m_strForeignName
    Значение, которое в связи, определяет имя объекта поля DAO во внешней таблице, которая соответствует полю в главной таблице. Дополнительные сведения см. в разделе «свойство ForeignName» в справке DAO.

  • m_strSourceField
    Указывает имя поля, первоисточник DAO поля данных для объекта, который содержит tabledef, набором записей, или объектом QueryDef. Это свойство указывает исходное имя поля, связанные с объектом поля. Например, можно использовать это свойство для указания первоисточник данных в поле запроса, имя которого не соответствует имени поля в базовой таблице. Дополнительные сведения см. в разделе «SourceField, свойства SourceTable» в справке DAO. Можно задать это свойство для tabledef с CDaoTableDef::CreateField.

  • m_strSourceTable
    Отображает имя таблицы, первоисточник DAO поля данных для объекта, который содержит tabledef, набором записей, или объектом QueryDef. Это свойство указывает имя исходной таблицы, связанные с объектом поля. Например, можно использовать это свойство для указания первоисточник данных в поле запроса, имя которого не соответствует имени поля в базовой таблице. Дополнительные сведения см. в разделе «SourceField, свойства SourceTable» в справке DAO. Можно задать это свойство для tabledef с CDaoTableDef::CreateField.

  • m_strValidationRule
    Значение, которое проверяет данные поля по мере их изменения или добавляется к таблице. Дополнительные сведения см. в разделе «свойство ValidationRule» в справке DAO. Можно задать это свойство для tabledef с CDaoTableDef::CreateField.

    Дополнительные сведения о tabledefs см. в описании элемента m_strValidationRule структуры CDaoTableDefInfo.

  • m_strValidationText
    Значение, указывающее текст сообщения, приложение отображает объекта DAO, если значение поля не удовлетворяет правило проверки, заданное параметром ValidationRule свойств. Дополнительные сведения см. в разделе «свойство ValidationText» в справке DAO. Можно задать это свойство для tabledef с CDaoTableDef::CreateField.

  • m_strDefaultValue
    Значение по умолчанию объекта поля DAO. Если создается новая запись, параметр свойства DefaultValue автоматически вводятся в качестве значения для поля. Дополнительные сведения см. в разделе «свойство DefaultValue» в справке DAO. Можно задать это свойство для tabledef с CDaoTableDef::CreateField.

Заметки

Ссылки на первичный, вторичный и всем выше показано, как сведения возвращаются функцией-членом GetFieldInfo в классах CDaoTableDef, CDaoQueryDef и CDaoRecordset.

Объекты поля не представлены классом MFC. Вместо этого объекты DAO основного объекты в основе MFC следующих классов содержат коллекции объектов поля: CDaoTableDef, CDaoRecordset и CDaoQueryDef. Эти классы предоставляют функций-членов для получения некоторые отдельные элементы данных полей, или можно получить все они непосредственно с объектом CDaoFieldInfo путем вызова функции-члена GetFieldInfo, содержащего объекта.

Помимо она используется для проверки свойства объекта можно также использовать CDaoFieldInfo построение входной параметр для создания новых полей в tabledef. Более простые доступны для этой задачи, но если требуется более явный элемент управления, можно использовать версию CDaoTableDef::CreateField, которая принимает параметр CDaoFieldInfo.

Сведения, GetFieldInfo (функцией-членом класса, содержащий поле) хранятся в структуре CDaoFieldInfo. Вызовите функцию-член объекта GetFieldInfo, в котором хранится объект коллекции полей поля. CDaoFieldInfo также определяет функции-члена Dump выполняется в режиме построения. Можно использовать Dump сбросить содержимое объекта CDaoFieldInfo.

Требования

Header: afxdao.h

См. также

Ссылки

CDaoTableDef::GetFieldInfo

CDaoRecordset::GetFieldInfo

CDaoQueryDef::GetFieldInfo

Другие ресурсы

Структуры, стили, обратные вызовы и схемы сообщений