Udostępnij za pośrednictwem


CDaoFieldInfo — Struktura

CDaoFieldInfo Struktura zawiera informacje dotyczące obiektu pola zdefiniowane dla obiektów dostępu do danych (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
    Unikatowej nazwy obiektu field.Aby uzyskać szczegółowe informacje zobacz temat "Właściwość Name" w pomocy DAO.

  • m_nType
    Wartość wskazująca typ danych pola.Aby uzyskać szczegółowe informacje zobacz temat "Właściwość Type" w pomocy DAO.Wartość tej właściwości może być jedną z następujących czynności:

    • dbBoolean tak/nie, taki sam jak TRUE/FAŁSZ

    • dbByte bajt

    • dbInteger krótki

    • dbLong długie

    • dbCurrency waluty; Zobacz klasy MFC COleCurrency

    • dbSingle pojedynczy

    • dbDouble podwójne

    • dbDate Data/Godzina; Zobacz klasy MFC COleDateTime

    • dbText tekstu; Zobacz klasy MFC CString

    • dbLongBinary Long Binary (obiekt OLE); Możesz chcieć używać klasy MFC CByteArray a nie klasy CLongBinary jako CByteArray jest bogatsze i łatwiejsze w użyciu.

    • dbMemo fakturę korygującą; Zobacz klasy MFCCString

    • dbGUID A Unikatowy identyfikator/Uniwersalnie unikatowy identyfikator globalny używany z zdalnego wywołania procedury.Aby uzyskać więcej informacji zobacz temat "Właściwość Type" w pomocy DAO.

    [!UWAGA]

    Nie używaj danych typu ciąg dla danych binarnych.Powoduje to dane przechodzą przez warstwę translacji Unicode/ANSI, wynikające w tłumaczeniu zwiększone obciążenie i ewentualnie nieoczekiwany.

  • m_lSize
    Wartość, która wskazuje maksymalny rozmiar, w bajtach, obiekt pole DAO, który zawiera tekst lub stały rozmiar obiektu pola zawierające wartości tekstowe lub liczbowe.Aby uzyskać szczegółowe informacje zobacz temat "Właściwość Size" w pomocy DAO.Rozmiary może mieć jedną z następujących wartości:

    Typ

    Rozmiar (bajty)

    Opis

    dbBoolean

    1 bajt

    Tak/nie (tak samo jak PRAWDA i FAŁSZ)

    dbByte

    1

    Bajt

    dbInteger

    2

    Liczba całkowita

    dbLong

    4

    Liczba długa

    dbCurrency

    8

    Waluta (COleCurrency)

    dbSingle

    4

    Pojedyncze

    dbDouble

    8

    Wartość dwubajtowa

    dbDate

    8

    Data i godzina (COleDateTime)

    dbText

    1 - 255

    Tekst (CString)

    dbLongBinary

    0

    Długa Binary (obiekt OLE; CByteArray; Użyj zamiast CLongBinary)

    dbMemo

    0

    Memo (CString)

    dbGUID

    16

    Globalnie unikatowy identyfikator/Uniwersalnie unikatowy identyfikator używany z zdalnego wywołania procedury.

  • m_lAttributes
    Określa właściwości obiektu pole zawarte przez tabledef, zestaw rekordów, querydef lub indeks obiektu.Wartość zwracana może być sumą tych stałych, utworzone za pomocą (wartość logiczną lub C++|) operator:

    • dbFixedField rozmiar pola jest stała (domyślne dla pól numerycznych).

    • dbVariableField rozmiar pola jest zmienna (tylko dla pól tekstowych).

    • dbAutoIncrField wartość pola dla nowych rekordów jest automatycznie zwiększany do unikatowych długa liczba całkowita, która nie może zostać zmieniona.Obsługiwane tylko dla tabel bazy danych Microsoft Jet.

    • dbUpdatableField wartości tego pola można zmienić.

    • dbDescending polu są sortowane w porządku malejącym (Z - A lub 100-0) zamówienia (dotyczy tylko obiekt field w kolekcji Fields obiektu indeksu; w MFC indeks obiekty są same zawarte w obiektach tabledef).Jeżeli pominięto stała ta pola są sortowane w kolejności rosnącej (A - Z lub 0 - 100) zamówienia (ustawienie domyślne).

    Sprawdzając ustawienie tej właociwooci można użyć C++ logiczną- i operator (&) do testowania konkretnego atrybutu.Podczas ustawiania wiele atrybutów, można je połączyć, łącząc odpowiednie stałe with (wartość logiczną lub**|**) operator.Aby uzyskać szczegółowe informacje zobacz temat "Właściwość Attributes" w pomocy DAO.

  • m_nOrdinalPosition
    Wartość, która określa numeryczny kolejność, w której ma być polem reprezentowany przez obiekt DAO pola mają być wyświetlane w stosunku do innych pól.Można ustawić tę właściwość z CDaoTableDef::CreateField.Aby uzyskać szczegółowe informacje zobacz temat "Właściwość OrdinalPosition" w pomocy DAO.

  • m_bRequired
    Wskazuje, czy obiekt DAO pole wymaga wartości inne niż Null.Jeśli ta właściwość jest TRUE, pola nie zezwala na wartości Null.Jeśli wymagane jest ustawiona na FALSE, pole może zawierać wartości Null, a także wartości, które spełniają warunki określone przez ustawienia właściwości ValidationRule (RegułaPoprawności) i AllowZeroLength.Aby uzyskać szczegółowe informacje zobacz temat "Właściwość Required" w pomocy DAO.Można ustawić tej właściwości dla obiektu tabledef z CDaoTableDef::CreateField.

  • m_bAllowZeroLength
    Wskazuje, czy ciąg pusty ("") jest prawidłową wartością obiektu DAO pola o typie danych tekst lub Nota.Jeśli ta właściwość jest TRUE, pusty ciąg jest prawidłową wartością.Właociwooć tę można ustawić, FALSE do zapewnienia, że pusty ciąg znaków nie można używać do ustawiania wartości pola.Aby uzyskać szczegółowe informacje zobacz temat "Właściwość AllowZeroLength" w pomocy DAO.Można ustawić tej właściwości dla obiektu tabledef z CDaoTableDef::CreateField.

  • m_lCollatingOrder
    Określa sekwencję porządku sortowania w tekście do porównywania ciągów znaków i sortowania.Aby uzyskać szczegółowe informacje zobacz temat "Dostosowywanie systemu Windows ustawienia dla danych dostępu do rejestru" w pomocy DAO.Aby uzyskać listę możliwych wartości zwracane, zobacz m_lCollatingOrder członek CDaoDatabaseInfo struktury.Można ustawić tej właściwości dla obiektu tabledef z CDaoTableDef::CreateField.

  • m_strForeignName
    Wartość, która w relacji, określa nazwę obiektu DAO pól tabeli obcej, która odnosi się do pola w tabeli podstawowej.Aby uzyskać szczegółowe informacje zobacz temat "Właściwość ForeignName" w pomocy DAO.

  • m_strSourceField
    Wskazuje nazwę pola, które jest oryginalne źródło danych dla obiektu pola DAO zawartych przez tabledef, zestawu rekordów lub obiektu querydef.Właściwość ta wskazuje się oryginalna nazwa pola skojarzonego z obiektem pól.Na przykład można użyć tej właściwości do określenia oryginalnego źródła danych w polu kwerendy, którego nazwa nie ma wpływu na nazwę pola w tabeli podstawowej.Aby uzyskać szczegółowe informacje zobacz temat "SourceField, właściwości elementu SourceTable" w pomocy DAO.Można ustawić tej właściwości dla obiektu tabledef z CDaoTableDef::CreateField.

  • m_strSourceTable
    Wskazuje nazwę tabeli, która stanowi oryginalne źródło danych dla obiektu pola DAO zawartych przez tabledef, zestawu rekordów lub obiektu querydef.Właściwość ta wskazuje oryginalnej nazwy tabeli skojarzonych z obiektem pól.Na przykład można użyć tej właściwości do określenia oryginalnego źródła danych w polu kwerendy, którego nazwa nie ma wpływu na nazwę pola w tabeli podstawowej.Aby uzyskać szczegółowe informacje zobacz temat "SourceField, właściwości elementu SourceTable" w pomocy DAO.Można ustawić tej właściwości dla obiektu tabledef z CDaoTableDef::CreateField.

  • m_strValidationRule
    Wartość, która sprawdza poprawność danych w polu, co to jest zmienione lub dodane do tabeli.Aby uzyskać szczegółowe informacje zobacz temat "Właściwość ValidationRule (RegułaPoprawności)" w pomocy DAO.Można ustawić tej właściwości dla obiektu tabledef z CDaoTableDef::CreateField.

    Aby uzyskać pokrewne informacje o tabledefs, zobacz m_strValidationRule członek CDaoTableDefInfo struktury.

  • m_strValidationText
    Wartość, która określa tekst komunikatu, który wyświetla aplikacji, jeśli wartość pola obiektu DAO nie spełnia reguły sprawdzania poprawności określonej przez ustawienie właściwości ValidationRule.Aby uzyskać szczegółowe informacje zobacz temat "Właściwość KomunikatOBłędzie" w pomocy DAO.Można ustawić tej właściwości dla obiektu tabledef z CDaoTableDef::CreateField.

  • m_strDefaultValue
    Wartość domyślna pola obiektu DAO.Podczas tworzenia nowego rekordu, ustawienie właociwooci DefaultValue automatycznie wprowadzana jest jako wartość dla pola.Aby uzyskać szczegółowe informacje zobacz temat "Właściwość DefaultValue" w pomocy DAO.Można ustawić tej właściwości dla obiektu tabledef z CDaoTableDef::CreateField.

Uwagi

Odniesienia do podstawowej i średniej oraz wszystkie powyższe wskazują, jak informacje zwracane przez GetFieldInfo funkcji składowej w klasach CDaoTableDef, CDaoQueryDef, i CDaoRecordset.

Pole obiekty nie są reprezentowane przez klasę MFC.Zamiast obiektów DAO podstawowych obiekty następujących klas MFC przechowywania zbiorów obiektów pól: CDaoTableDef, CDaoRecordset, i CDaoQueryDef.Funkcje składowe dostęp niektórych pojedynczych elementów informacji z pola do zasilania tych klas lub uzyskiwania dostępu do nich w całości z CDaoFieldInfo obiekt poprzez wywołanie GetFieldInfo funkcji składowej obiektu zawierającego.

Oprócz jej stosowania do badania właściwości obiektu, można również użyć CDaoFieldInfo do konstruowania parametr wejściowy przy tworzeniu nowych pól w tabledef.Prostsze opcje są dostępne dla tego zadania, ale jeśli chcesz mieć większą kontrolę, można użyć wersji CDaoTableDef::CreateField pobierająca CDaoFieldInfo parametru.

Informacje pobierane przez GetFieldInfo funkcji składowej (klasy zawierającej pole) są przechowywane w CDaoFieldInfo struktury.Wywołanie GetFieldInfo funkcji składowej obiektu zawierającego, w których kolekcji Fields obiektu pola jest przechowywany.CDaoFieldInfodefiniuje również Dump tworzy funkcję członka w debugowania.Można użyć Dump do zrzutu zawartości CDaoFieldInfo obiektu.

Wymagania

Nagłówek: afxdao.h

Zobacz też

Informacje

CDaoTableDef::GetFieldInfo

CDaoRecordset::GetFieldInfo

CDaoQueryDef::GetFieldInfo

Inne zasoby

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