Represents a collection of documents from a database, selected according to specific criteria.
Contained by: NotesDatabase, NotesSession, NotesUIDatabase, NotesUIView, NotesUIWorkspace
Contains: NotesDocument
A NotesDocumentCollection represents a subset of all the documents in a database. The documents in the subset are determined by the NotesDatabase method or property you use to search the database, which can be any of the following:
Both NotesDocumentCollection and NotesView objects provide access to documents within a database. Use a NotesDocumentCollection object if:
Views are a more efficient means of accessing documents because they are already indexed by the database itself. However, they do not necessarily provide access to the documents that you want.
The documents in a collection are ordered when the collection results from a full-text search; otherwise, the documents are unordered.
A current pointer is maintained for document collections. All navigation methods set the current pointer to the retrieved document with the following exceptions. Add and delete methods do not move the current pointer. The following methods set the current pointer to the first document: FTSearch, RemoveAll (remote IIOP only), PutAllInFolder, RemoveAllFromFolder, and StampAll.