CDaoRecordset::IsBOF

(BOOL IsBOF) stała;
rzut (CDaoException, CMemoryException);

Wartość zwracany

Niezerowa, jeśli zestaw rekordów zawiera żadnych rekordów, czy też były przewijane do tyłu przed pierwszą rekordu; inny sposób 0.

Uwagi

Wywołanie tej funkcji członek przed podczas przewijania z rekordu do rekordu, aby dowiedzieć się, czy jesteś przed pierwszą rekordu zestawu rekordów. Można również wywołać IsBOF wraz z IsEOF do ustalenia, czy zestaw rekordów zawiera wszystkie rekordy lub jest pusty. Natychmiast po wywołaniu otwarte, jeśli zestaw rekordów zawiera żadnych rekordów, IsBOF zwraca wartość różną od zera. Po otwarciu zestaw rekordów, zawierający co najmniej jeden rekord, pierwszy rekord jest aktualnym rekordem i IsBOF zwraca 0.

Jeśli pierwszy rekord jest aktualnym rekordem, a wywołania MovePrev, IsBOF następnie zwróci niezerową. Jeśli IsBOF zwraca wartość różną od zera i wywołania MovePrev, wyjątek jest generowany. Jeśli IsBOF zwraca wartość różną od zera, bieżący rekord jest niezdefiniowana, a wszelkie działania, które wymaga bieżącego rekordu spowoduje wygenerowanie wyjątku.

Efekt szczególnych metod IsBOF i IsEOF ustawienia:

Wywołanie Open wewnętrznie dokonuje pierwszego rekordu w zestawie rekordów bieżącego rekordu przez wywołanie MoveFirst. W związku z tym Otwórz wzywając pustego zestawu rekordów powoduje IsBOF i IsEOF zwracają niezerową. (Zobacz w poniższej tabeli zachowanie nie powiodło się wywołanie MoveFirst lub MoveLast ).
Wszystkie operacje Przenieś pomyślnie zlokalizować rekord powoduje zarówno IsBOF , jak i IsEOF zwraca 0.
Wywołanie AddNew następuje wywołanie aktualizacji , który pomyślnie wstawia nowy rekord powoduje IsBOF zwraca 0, ale tylko jeśli IsEOF już jest różna od zera. Państwo IsEOF zawsze pozostanie niezmieniona. Zdefiniowana przez aparat bazy danych Microsoft Jet, bieżący wskaźnik rekordu pustym zestawem rekordów jest na końcu pliku, więc każdy nowy rekord dodaje się po bieżącym rekordzie.
Każde wywołanie usunięcia , nawet jeśli usuwa tylko rekord pozostałe z zestawu rekordów, będzie zmienia wartość IsBOF lub IsEOF.

W tej tabeli zestawiono, które operacji przenoszenia dopuszcza się z różnymi kombinacjami IsBOF/IsEOF.

	MoveFirst, MoveLast	MovePrev, Przenieść < 0	Przenieść 0	MoveNext, &Przenieść BT; 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 oznacza że operacja zostanie pomyślnie lokalizowanie rekordu. Jedynie wskazuje, że podjęto próbę wykonania określonych operacji przenoszenia jest dozwolone, a nie wygeneruje wyjątek. Wartość funkcji członek IsBOF i IsEOF może się zmieniać od próba przejścia.

W poniższej tabeli przedstawiono efekt operacji przenoszenia, które nie zlokalizować rekord na wartość ustawienia IsBOF i IsEOF.

	IsBOF	IsEOF
MoveFirst, MoveLast	Niezerowa	Niezerowa
Przenieść 0	Bez zmian	Bez zmian
MovePrev, przenieść < 0	Niezerowa	Bez zmian
&MoveNext, przenieść BT; 0	Bez zmian	Niezerowa

Aby uzyskać więcej informacji na temat nawigacji w zestawy rekordów, zobacz artykuł zestawu rekordów DAO: nawigacji zestawu rekordów w Visual C++ Programmer's Guide. Aby uzyskać pokrewne informacje, zobacz temat „BOF, właściwości EOF "w pomocy programu DAO.

Omówie&nie CDaoRecordset |nbsp; Klasa członków | Wykres hierarchii

Zobacz też CDaoRecordset::IsEOF

Index