---
title: clsChapterCollection
summary: API reference for clsChapterCollection.
status: draft
owner: Technical Writer
last_reviewed: 2026-07-31
library: SAIF.Business.Policy.Group
reference_type: package
---

# clsChapterCollection

Holds all chapters for one group and supports active-date and code-based filtering.

## Purpose
- Holds all chapters for one group and supports active-date and code-based filtering.

## Context
- Namespace: `SAIF.Business.Policy.Group`
- Assembly/package: `SAIF.Business.Policy.Group`

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| CurrentItem | `Public Shadows ReadOnly Property CurrentItem() As clsChapter` | Returns the collection's current chapter for callers using BOF cursor-style traversal.* |
| ActiveChapters | `Public ReadOnly Property ActiveChapters(ByVal inSelectDate As Date) As IEnumerable(Of clsChapter)` | Filters chapter rows to the ones active on the supplied date ([BR-006](../../../../../business-rules.md#br-006-chapter-activity-is-bounded-by-effective-dates)). |
| ChaptersByCode | `Public ReadOnly Property ChaptersByCode(ByVal inGroupChapterCode As String) As IEnumerable(Of clsChapter)` | Returns only the chapter rows whose chapter code matches the requested value.* |
| Save | `Public Overrides Function Save() As Boolean` | Persists pending child inserts, updates, and deletes for this collection through the BOF save pipeline.* |
| Add | `Public Shadows Function Add(ByVal inChapter As clsChapter) As Integer` | Adds the supplied chapter to the in-memory collection so a later save can persist it.* |
| Contains | `Public Overloads Function Contains(ByVal inChapter As clsChapter) As Boolean` | Checks whether the active collection already contains an item matching the supplied chapter.* |
| Contains | `Public Overloads Function Contains(ByVal inGroupAssociationCode As String) As Boolean` | Checks whether the active collection already contains an item matching the supplied group association code.* |
| Where | `Public Function Where(ByVal match As Predicate(Of clsChapter)) As clsChapterCollection` | Returns a filtered view of the collection using the callers predicate.* |
| GetChapters | `Public Shared Function GetChapters(ByVal inDataportal As IDataPortalInfo, ByVal inGroupAssociationCode As String) As clsChapterCollection` | Loads all chapter rows for the supplied group association code so callers can filter or seed placeholder chapters ([BR-005](../../../../../business-rules.md#br-005-group-exposes-a-placeholder-chapter-when-none-exist)). |

## Inherited public members

| Member | Signature | Purpose | Origin |
| --- | --- | --- | --- |
| First | `Sub First()` | Moves inherited collection traversal to the first item.† | `SAIF.Framework.Core — clsBusinessCollectionBase` |
| Last | `Sub Last()` | Moves inherited collection traversal to the last item.† | `SAIF.Framework.Core — clsBusinessCollectionBase` |
| Next | `Sub Next()` | Moves inherited collection traversal to the next item.† | `SAIF.Framework.Core — clsBusinessCollectionBase` |
| Previous | `Sub Previous()` | Moves inherited collection traversal to the previous item.† | `SAIF.Framework.Core — clsBusinessCollectionBase` |
| SetCurrent | `Sub SetCurrent(item As Object)` | Changes the inherited current-item cursor for traversal.† | `SAIF.Framework.Core — clsBusinessCollectionBase` |
| Traverse | `Sub Traverse(...)` | Executes inherited collection traversal across the BOF list.† | `SAIF.Framework.Core — clsBusinessCollectionBase` |
| Error | `ReadOnly Property Error As String` | Surfaces inherited aggregate broken-rule text for the collection.† | `SAIF.Framework.Core — clsBusinessCollectionBase` |
| Item | `ReadOnly Property Item(columnName As String) As String` | Surfaces inherited per-member broken-rule text for the collection.† | `SAIF.Framework.Core — clsBusinessCollectionBase` |

## Behavioral notes
- This type follows the BOF business-object or collection lifecycle exposed by its public surface.*

## Constraints and usage notes
- Most create, retrieve, and save flows rely on BOF criteria and data-portal behavior inherited from the framework base layer.†

> **Note:** Statements marked with * were inferred from code structure, naming conventions, or
> contextual evidence where direct confirmation was not available in source artifacts. Statements
> marked with ** could not be confirmed; treat as unknown until verified.
> Statements marked with `†` were retrieved from dependency library documentation via the Legends CLI RAG service.

## Sources
- `Business\\SAIF.Business.Policy.Group\\clsChapterCollection.vb`