Struktura CDaoFieldInfo

Struktura CDaoFieldInfo ma następującą postać:

struct CDaoFieldInfo
{
 nbsp; CString m_str&Name;           / / Podstawowy
   krótkie m_nType;               / / Podstawowy
   długi m_lSize;                / / Podstawowy
   długi m_lAttributes;          / / Podstawowy
   krótkie m_nOrdinalPosition;    / / Pomocnicze
   BOOL m_bRequired;            / / Pomocnicze
   BOOL m_bAllowZeroLength;     / / Pomocnicze
   długi m_lCollatingOrder;      / / Pomocnicze
   CString m_strForeignName;    / / Pomocnicze
   CString m_strSourceField;    / / Pomocnicze
   CString m_strSourceTable;    / / Pomocnicze
   CString m_strValidationRule; / / All
   CString m_strValidationText; / / All
   CString m_strDefaultValue;   / / All
}

Struktura CDaoFieldInfo zawiera informacje dotyczące obiektu pola zdefiniowane dla obiektów data access objects (DAO). Odniesienia do podstawowego, średniego i wszystkie powyższe wskazuje, jak informacje są zwracane przez funkcję Państwa GetFieldInfo klasy CDaoTableDef, CDaoQueryDefi CDaoRecordset.

Obiekty pól nie są reprezentowane przez klasy MFC. Zamiast tego obiektów DAO, leżących u podstaw MFC obiekty następujących klas zawiera kolekcje obiektów pola: CDaoTableDef, CDaoRecordseti CDaoQueryDef. Klasy te dostarczają funkcje składowe dostęp do niektórych poszczególnych elementów pola informacji lub dostęp można uzyskać je wszystkie na raz z obiektem CDaoFieldInfo przez wywołanie funkcji członek GetFieldInfo obiektu zawierającego.

Poza jej stosowania do badania właściwości obiektu można również używać CDaoFieldInfo do konstruowania parametr wejściowy do tworzenia nowych pól zreplikowany. Prostsze, opcje są dostępne dla tego zadania, ale jeśli chcesz precyzji, można użyć wersji CDaoTableDef::CreateField , która przyjmuje parametr CDaoFieldInfo.

Członkowie

m_strName

Jednoznacznie nazw obiektu field. Aby uzyskać szczegółowe informacje zobacz temat "Właściwość Name" w pomocy programu DAO.

m_nType

Wartość, który wskazuje typ danych pola. Szczegóły można znaleźć w temacie „właściwość Type"w pomocy programu DAO. Wartość tej właściwości może być jedną z następujących czynności:

dbBoolea&nnbsp; Tak/nie podobnie jak Prawda/Fałsz
dbByte Bajt
dbI&ntegernbsp; Krótkie
dbLo&ngnbsp; Długie
dbCurre&ncynbsp; Waluty; Zobacz MFC klasy COleCurrency
dbSi&nglenbsp; Pojedynczy
dbDouble Podwójne
dbDate Data/godzina; Zobacz MFC klasy COleDateTime
dbText Tekst; Zobacz MFC klasy CString
dbLo&ngBinarynbsp; Long Binary (obiekt OLE); warto użyć klasy MFC CByteArray zamiast klasy CLongBinary , jak CByteArray jest bogatszy i łatwiejszy w użyciu.
dbMemonbsp; &Nota; Zobacz MFC klasy CString
dbGUID Globalnie unikatowy identyfikator/Uniwersalnie unikatowy identyfikator używany ze zdalnego wywołania procedury. Aby uzyskać więcej informacji zobacz temat „Właściwość Type"w pomocy programu DAO.
Uwaganbsp; &Nie należy używać ciągu typów danych binarnych. Powoduje to, że dane przechodzić przez warstwę tłumaczenie Unicode/ANSI, wynikające w tłumaczeniu zwiększone obciążenie i ewentualnie nieoczekiwany.

m_lSize

Wartość, która wskazuje maksymalny rozmiar, w bajtach, obiektu pola DAO, który zawiera tekst lub stałego rozmiaru obiektu pola zawierające wartości tekstowe lub liczbowe. Szczegóły można znaleźć w temacie „właściwości rozmiar"w pomocy programu DAO. Rozmiary może mieć jedną z następujących wartości:

Typ	Rozmiar (bajty)	Opis
dbBoolean	1 bajt	Tak/nie (taki sam, jak wartość PRAWDA/FAŁSZ)
dbByte	1	Bajt
dbInteger	2	Liczba całkowita
dbLong	4	Długie
dbCurrency	8	Waluta (COleCurrency)
dbSingle	4	Pojedynczy
dbDouble	8	Podwójne
dbDate	8	Data/godzina (COleDateTime)
dbText	1 - 255	Tekst (CString)
dbLongBinary	0	Long Binary (obiekt OLE; CByteArray; Użyj zamiast CLongBinary)
dbMemo	0	Nota (CString)
dbGUID	16	Globalnie unikatowy identyfikator/Uniwersalnie unikatowy identyfikator używany ze zdalnego wywołania procedury.

m_lAttributes

Określa właściwości obiektu pola zawarte przez zreplikowany, zestawu rekordów, querydef lub indeks obiektu. Wartość zwracany może być suma tych stałych, utworzone za pomocą operatora C++ logiczną lub (|):

dbFixedField Rozmiar pola jest stałe (domyślne dla pól numerycznych).
dbVariableField Rozmiar pola jest zmienna (tylko dla pól tekstowych).
dbAutoI&ncrFieldnbsp; Wartość pola dla nowych rekordów jest automatycznie zwiększana unikatowy długa, który nie może być zmieniony. Obsługiwane tylko dla tabel bazy danych Microsoft Jet.
dbUpdatableField Wartość pola można zmienić.
dbDesce&ndingnbsp; Pole jest posortowane w malejącej (Z - A lub 100-0) zamówienia (stosuje się tylko do obiektu pola zbiór pól obiektu indeksu; w MFC, indeks obiektów są same zawarte w obiektach zreplikowany). Pominięcie tej stałej pole jest sortowana w kolejności rosnącej (A - Z lub 0 - 100) zamówienia (wartość domyślna).
Sprawdzając ustawienie tej właściwości można używać C++ operatory- I operatora (amp;) do badania dla konkretnego atrybutu. Podczas ustawiania wielu atrybutów, można je połączyć, łącząc odpowiednie stałe z operatorem logiczną lub (|). &Aby uzyskać szczegółowe informacje zobacz temat "Atrybuty właściwości" w pomocy programu DAO.

m_nOrdinalPosition

Wartość, która określa numeryczny kolejność, w której chcesz polem, reprezentowane przez obiekt pola DAO mają być wyświetlane względem innych pól. Można ustawić tę właściwość z CDaoTableDef::CreateField. Aby uzyskać szczegółowe informacje zobacz temat "OrdinalPosition właściwości" w pomocy programu DAO.

m_bRequired

Wskazuje, czy obiekt pola DAO wymaga wartości inne niż Null. Jeśli ta właściwość ma wartość TRUE, to pole nie zezwala na wartość Null. Jeśli wymagane jest ustawiona na wartość FALSE, to 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 AllowZeroLength i ValidationRule (RegułaPoprawności). Szczegóły można znaleźć w temacie "Wymagana własność" w pomocy programu DAO. Można ustawić tę właściwość zreplikowany z CDaoTableDef::CreateField.

m_bAllowZeroLength

Wskazuje, czy pusty ciąg ("") jest prawidłową wartością obiektu DAO pola o typie danych tekst lub Nota. Jeśli ta właściwość ma wartość TRUE, pusty ciąg jest prawidłową wartością. Właściwość tę można ustawić na wartość FALSE dla zapewnienia, że nie można użyć pusty ciąg znaków wartości pola. Szczegóły można znaleźć w temacie "Właociwooć AllowZeroLength" w pomocy programu DAO. Można ustawić tę właściwość zreplikowany z CDaoTableDef::CreateField.

m_lCollatingOrder

Określa kolejność sortowania w tekście do porównywania ciągów znaków lub sortowania. Szczegóły można znaleźć w temacie „Dostosowywanie systemu Windows Ustawienia dla danych dostęp do rejestru"w pomocy DAO. Lista możliwych wartości zwracane zobacz członek m_lCollatingOrder struktury CDaoDatabaseInfo . Można ustawić tę właściwość zreplikowany z CDaoTableDef::CreateField.

m_strForeignName

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

m_strSourceField

Wskazuje nazwę pola, która jest oryginalne źródło danych dla obiektu pola DAO zawartych przez zreplikowany, zestawu rekordów lub obiektu querydef. Właściwość ta wskazuje, oryginalna nazwa pola skojarzone z obiektem pola. Za pomocą tej właściwości może na przykład określić oryginalnego źródła danych w polu kwerendy, którego nazwa jest niepowiązanych 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ć tę właściwość zreplikowany z CDaoTableDef::CreateField.

m_strSourceTable

Wskazuje nazwę tabeli, która jest oryginalne źródło danych dla obiektu pola DAO zawartych przez zreplikowany, zestawu rekordów lub obiektu querydef. Właściwość ta wskazuje, oryginalna nazwa tabeli skojarzone z obiektem pola. Za pomocą tej właściwości może na przykład określić oryginalnego źródła danych w polu kwerendy, którego nazwa jest niepowiązanych 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ć tę właściwość zreplikowany z CDaoTableDef::CreateField.

m_strValidationRule

Wartość, która sprawdza poprawność danych w polu jest zmieniane lub dodane do tabeli. Szczegóły można znaleźć w temacie "Właściwości ValidationRule (RegułaPoprawności)" w pomocy programu DAO. Można ustawić tę właściwość zreplikowany z CDaoTableDef::CreateField.

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

m_strValidationText

Wartość, która określa tekst komunikatu, który aplikacja wyświetla, jeśli wartość pola obiektu DAO nie spełnia reguły sprawdzania poprawnooci, określonym przez ustawienie właściwości ValidationRule (RegułaPoprawności). Szczegóły można znaleźć w temacie „właściwość KomunikatOBłędzie"w pomocy programu DAO. Można ustawić tę właściwość zreplikowany z CDaoTableDef::CreateField.

m_strDefaultValue

Wartość domyślna pola obiektu DAO. Po utworzeniu nowego rekordu ustawienia właściwości DefaultValue jest automatycznie wprowadzana jako wartość dla pola. Szczegóły można znaleźć w temacie „właściwości DefaultValue"w pomocy programu DAO. Można ustawić tę właściwość zreplikowany z CDaoTableDef::CreateField.

Komentarze

Informacje pobierane przez funkcję Państwa GetFieldInfo (z klasy, która zawiera pole) są przechowywane w strukturze CDaoFieldInfo . Wywołania funkcji członek GetFieldInfo obiektu zawierającego, w których zbieranie pola obiektu pola jest przechowywany. CDaoFieldInfo definiuje również funkcję Państwa zrzutu w kompilacji programu debug. Można użyć zrzutu do zrzutu zawartość obiektu CDaoFieldInfo.

Informacji na temat używania tego i innych struktur MFC DAO o użytkowniku, zobacz artykuł kolekcji obiektów DAO: uzyskiwanie informacji na temat obiektów DAO w Visual C++ Programmer's Guide.

Zobacz też CDaoTableDef::GetFieldInfo, CDaoRecordset::GetFieldInfo, CDaoQueryDef::GetFieldInfo

Index