---
title: clsMenuItemCollection
summary: API reference for clsMenuItemCollection.
status: draft
owner: SAIF
last_reviewed: 2026-07-24
library: SAIF.Business.Menu
reference_type: package
---

# clsMenuItemCollection

`clsMenuItemCollection` is a BOF collection that retrieves all `clsMenuItem` records from the `MENU_ITEM` table.

## Purpose
- Return the full set of menu items for presentation-layer consumption or administrative management.

## Context
- Namespace: `SAIF.Business.Menu`
- Assembly/package: `SAIF.BOF.Business.Menu`

## Public members

| Member | Signature | Purpose |
| --- | --- | --- |
| `Item(inMenuItemSeqNum)` | `Default ReadOnly Property Item(ByVal inMenuItemSeqNum As Decimal) As clsMenuItem` | Returns the `clsMenuItem` with the matching sequence number, or `Nothing` if not found.* |
| `CurrentItem` | `ReadOnly Property CurrentItem() As clsMenuItem` | Shadows base `CurrentItem`; returns the currently positioned item cast as `clsMenuItem`.* |
| `Add(inclsMenuItem)` | `Function Add(ByVal inclsMenuItem As clsMenuItem) As Integer` | Shadows base `Add`; appends a `clsMenuItem` to the collection.* |
| `Contains(inclsMenuItem)` | `Function Contains(ByVal inclsMenuItem As clsMenuItem) As Boolean` | Returns `True` if the collection contains the given object instance.* |
| `Contains(inMenuItemSeqNum)` | `Function Contains(ByVal inMenuItemSeqNum As Decimal) As Boolean` | Returns `True` if the collection contains an item matching the sequence number.* |
| `ContainsDeleted(inclsMenuItem)` | `Function ContainsDeleted(ByVal inclsMenuItem As clsMenuItem) As Boolean` | Returns `True` if the deleted-items list contains the given object instance.* |
| `ContainsDeleted(inMenuItemSeqNum)` | `Function ContainsDeleted(ByVal inMenuItemSeqNum As Decimal) As Boolean` | Returns `True` if the deleted-items list contains an item matching the sequence number.* |
| `Remove(inMenuItemSeqNum)` | `Sub Remove(ByVal inMenuItemSeqNum As Decimal)` | Removes the item matching the given sequence number from the collection.* |
| `Where(match)` | `Function Where(ByVal match As Predicate(Of clsMenuItem)) As clsMenuItemCollection` | Returns a filtered sub-collection of items matching the predicate.* |
| `NewMenuItems` | `Shared Function NewMenuItems(ByVal inDataportal As IDataPortalInfo) As clsMenuItemCollection` | Factory method; creates a new (empty) collection via the Data Portal.* |
| `GetAllMenuItems` | `Shared Function GetAllMenuItems(ByVal inDataportal As IDataPortalInfo) As clsMenuItemCollection` | Factory method; retrieves all `MENU_ITEM` records via the Data Portal.* |
| `Save` | `Function Save() As Boolean` | Calls `ApplyEdit()` then delegates to the base `Save()`; persists all dirty child items.* |

## Inherited public members

The members below come from the BOF collection framework (`clsBusinessCollectionBase`) that underpins `clsMenuItemCollection` through `clsBusinessCollection(Of T)`.

| Member | Signature | Purpose |
| --- | --- | --- |
| `MyGuid` | `Public ReadOnly Property MyGuid() As String` | Returns the collection's generated GUID identifier. |
| `ItemByGuid` | `Public ReadOnly Property ItemByGuid(ByVal inGuid As String) As clsBusinessBase` | Returns the child item with the matching framework GUID, if present. |
| `Rules` | `Public ReadOnly Property Rules() As clsRulesManager` | Exposes the collection-level rules manager. |
| `ErrorCount` | `Public ReadOnly Property ErrorCount() As Integer` | Returns the number of current validation errors. |
| `ErrorMessages` | `Public ReadOnly Property ErrorMessages() As String()` | Returns the current validation error messages. |
| `WarningCount` | `Public ReadOnly Property WarningCount() As Integer` | Returns the number of current warning messages. |
| `WarningMessages` | `Public ReadOnly Property WarningMessages() As String()` | Returns the current warning messages. |
| `InformationalCount` | `Public ReadOnly Property InformationalCount() As Integer` | Returns the number of informational validation messages. |
| `InformationalMessages` | `Public ReadOnly Property InformationalMessages() As String()` | Returns the current informational messages. |
| `ValidateAllChildren` | `Public Overridable Property ValidateAllChildren() As Boolean` | Controls whether validation checks every child before returning validity. |
| `IsDirty` | `Public ReadOnly Property IsDirty() As Boolean` | Indicates whether any active or deleted child has unsaved changes. |
| `IsValid` | `Public Overridable ReadOnly Property IsValid() As Boolean` | Validates the collection and its children and reports whether the collection is valid. |
| `BeginEdit` | `Public Sub BeginEdit()` | Starts a nested edit session for the collection and its children. |
| `CancelEdit` | `Public Sub CancelEdit()` | Cancels the current edit session and restores the prior snapshot. |
| `ApplyEdit` | `Public Sub ApplyEdit()` | Commits the current edit session for the collection and its children. |
| `Remove` | `Public Sub Remove(ByVal inChild As clsBusinessBase)` | Removes the supplied child business object from the collection. |
| `Item` | `Default Public ReadOnly Property Item(ByVal index As Integer) As clsBusinessBase` | Returns the child object at the specified zero-based index. |
| `Clone` | `Public Function Clone() As Object` | Creates a cloned copy of the collection. |
| `SaveChild` | `Public Overridable Function SaveChild() As Boolean` | Persists the collection when it is being managed as a child object. |
| `IsManaged` | `Public ReadOnly Property IsManaged() As Boolean` | Indicates whether the collection is operating in managed mode. |
| `IsFirst` | `Public ReadOnly Property IsFirst(ByVal inItem As clsBusinessBase) As Boolean` | Returns `True` when the supplied child is the first item in traversal order. |
| `First` | `Public Function First() As clsBusinessBase` | Moves traversal to the first item and returns it. |
| `FirstItem` | `Public ReadOnly Property FirstItem() As clsBusinessBase` | Returns the first item in the collection. |
| `Next` | `Public Function Next() As clsBusinessBase` | Advances traversal to the next item and returns it. |
| `IsNext` | `Public ReadOnly Property IsNext(ByVal inItem As clsBusinessBase) As Boolean` | Returns `True` when the supplied child is immediately after the current traversal position. |
| `NextItem` | `Public ReadOnly Property NextItem() As clsBusinessBase` | Returns the next item relative to the current traversal position. |
| `NextItem` | `Public ReadOnly Property NextItem(ByVal inRefPoint As clsBusinessBase) As clsBusinessBase` | Returns the item immediately after the supplied reference item. |
| `IsLast` | `Public ReadOnly Property IsLast(ByVal inItem As clsBusinessBase) As Boolean` | Returns `True` when the supplied child is the last item in traversal order. |
| `LastItem` | `Public ReadOnly Property LastItem() As clsBusinessBase` | Returns the last item in the collection. |
| `Last` | `Public Function Last() As clsBusinessBase` | Moves traversal to the last item and returns it. |
| `CurrentIndex` | `Public ReadOnly Property CurrentIndex() As Integer` | Returns the current traversal index. |
| `IsCurrent` | `Public ReadOnly Property IsCurrent(ByVal inItem As clsBusinessBase) As Boolean` | Returns `True` when the supplied child is the current traversal item. |
| `SetCurrent` | `Public Sub SetCurrent(ByRef inObject As clsBusinessBase)` | Sets the current traversal item by object reference. |
| `SetCurrent` | `Public Sub SetCurrent(ByVal inIndex As Integer)` | Sets the current traversal item by zero-based index. |
| `IndexOf` | `Public ReadOnly Property IndexOf(ByVal inObject As clsBusinessBase) As Integer` | Returns the index of the supplied child object. |
| `IsPrevious` | `Public ReadOnly Property IsPrevious(ByVal inItem As clsBusinessBase) As Boolean` | Returns `True` when the supplied child is immediately before the current traversal position. |
| `Previous` | `Public Function Previous() As clsBusinessBase` | Moves traversal to the previous item and returns it. |
| `PreviousItem` | `Public ReadOnly Property PreviousItem() As clsBusinessBase` | Returns the previous item relative to the current traversal position. |
| `PreviousItem` | `Public ReadOnly Property PreviousItem(ByVal inRefPoint As clsBusinessBase) As clsBusinessBase` | Returns the item immediately before the supplied reference item. |
| `XMLElementName` | `Public Property XMLElementName() As String` | Gets or sets the root element name used when emitting collection XML. |
| `XMLItemName` | `Public Property XMLItemName() As String` | Gets or sets the element name used for individual child items in XML output. |
| `GetReportXML` | `Public Function GetReportXML(ByVal inElementName As String) As String` | Generates report-oriented XML using the supplied root element name. |
| `GetReportXML` | `Public Function GetReportXML(Optional ByVal inFileStream As System.IO.StreamWriter = Nothing) As String` | Generates report-oriented XML and can optionally stream the output while building it. |
| `ToXML` | `Public Function ToXML() As String` | Serializes the collection to XML using the configured default names. |
| `ToXml` | `Public Function ToXml(ByVal inTagName As String) As String` | Serializes the collection to XML using the supplied root tag name. |

## Behavioral notes
- `BeforeRetrieve` executes [SQL-023](../../sql/SQL-023-saif-business-menu.md) with no parameters, returning all menu item rows.
- `AfterRetrieve` iterates an `IDataReader`, creates `clsMenuItem` child objects, and appends each to the collection.*

## Constraints and usage notes
- No server-side filtering is supported; callers filter the returned collection if needed.

> **Note:** Statements marked with `*` were inferred from code structure, naming conventions, or contextual evidence where direct confirmation was not available in source artifacts.

## Sources
- `Legacy\BusinessObjectFramework\clsBusinessCollectionBase.vb`
- `Business\SAIF.Business.Menu\clsMenuItemCollection.vb`