CDaoRecordset::IsBOF
Wywołanie tej funkcji Członkowskich przed przewiń z rekordu do rekordu, aby dowiedzieć się, czy jesteś przed pierwszego rekordu w zestawie rekordów.
BOOL IsBOF( ) const;
Wartość zwracana
Niezerowa, jeśli zestaw rekordów nie zawiera żadnych rekordów lub były przewijane wstecz przed pierwszym rekordzie; 0 inaczej.
Uwagi
Można również wywołać IsBOF z IsEOF czy zestaw rekordów zawiera rekordy, czy jest pusty.Natychmiast po wywołaniu Otwórz, jeśli zestaw rekordów nie zawiera żadnych rekordów, IsBOF zwraca wartość niezerową.Po otwarciu zestawu rekordów, który ma co najmniej jeden rekord pierwszy rekord jest rekordem bieżącym i IsBOF zwraca wartość 0.
Jeśli pierwszy rekord jest rekordem bieżącym i wywołania MovePrev, IsBOF następnie zwróci niezerową.Jeśli IsBOF i zwraca wartość niezerową wywołania MovePrev, wyjątek.Jeśli IsBOF niezerowych zwraca bieżący rekord jest niezdefiniowany i wszelkie działania, które wymaga bieżącego rekordu spowoduje wyjątek.
Efekt szczególnych metod na IsBOF i IsEOF ustawienia:
Wywołanie Otwórz wewnętrznie czyni pierwszy rekord w zestawie rekordów bieżącego rekordu, wywołując MoveFirst.Dlatego wywołanie Otwórz z pustego zestawu rekordów powoduje IsBOF i IsEOF do zwracania niezerową.(Zobacz następującą tabelę dla zachowania nieudanej MoveFirst lub MoveLast call.)
Wszystkie operacje Przenieś pomyślnie Zlokalizuj rekord spowodować zarówno IsBOF i IsEOF zwraca 0.
AddNew Następuje wywołanie Aktualizacja spowoduje wywołanie, które pomyślnie wstawia nowy rekord IsBOF zwraca 0, ale tylko wtedy, gdy IsEOF już jest różna od zera.Stan IsEOF zawsze pozostają niezmienione.Zdefiniowane przez aparat bazy danych Microsoft Jet bieżącego wskaźnika rekord z pustym zestawem rekordów jest na końcu pliku, więc każdy nowy rekord dodaje się po bieżącym rekordzie.
Każdy usunąć rozmowy, nawet jeśli usuwa tylko pozostałe rekordu z zestawu rekordów nie zmieni wartość IsBOF lub IsEOF.
W poniższej tabeli przedstawiono operacje przenoszenia dozwolone z różnymi kombinacjami IsBOF/IsEOF.
|
MoveFirst MoveLast |
MovePrev, Przenieść < 0 |
Przenieść 0 |
MoveNext, Przenieś > 0 |
|---|---|---|---|---|
IsBOF= niezerową, IsEOF=0 |
Dozwolone |
Wyjątek |
Wyjątek |
Dozwolone |
IsBOF=0, IsEOF= niezerowe |
Dozwolone |
Dozwolone |
Wyjątek |
Wyjątek |
Zarówno niezerowe |
Wyjątek |
Wyjątek |
Wyjątek |
Wyjątek |
Zarówno 0 |
Dozwolone |
Dozwolone |
Dozwolone |
Dozwolone |
Umożliwiając operacji przenoszenia nie oznacza operację pomyślnie zlokalizuje rekordu.Wskazuje jedynie, że próba wykonania określonych operacji przenoszenia jest dozwolone i nie wygeneruje wyjątek.Wartość IsBOF i IsEOF funkcji elementów członkowskich może zmienić w wyniku próby przenoszenia.
Efekt operacji przenoszenia, które nie Zlokalizuj rekord na wartość IsBOF i IsEOF ustawienia jest pokazane w poniższej tabeli.
|
IsBOF |
IsEOF |
|---|---|---|
MoveFirst,MoveLast |
Niezerowa |
Niezerowa |
Przenieść 0 |
Żadna zmiana |
Żadna zmiana |
MovePrev, Move < 0 |
Niezerowa |
Żadna zmiana |
MoveNext, Move > 0 |
Żadna zmiana |
Niezerowa |
Aby uzyskać pokrewne informacje, zobacz temat "BOF, właściwości EOF" w pomocy DAO.
Wymagania
Nagłówek: afxdao.h