---
title: "clsMenuItemCollection"
summary: "API reference for clsMenuItemCollection."
status: draft
owner: SAIF documentation team
last_reviewed: 2026-08-17
library: SAIF.Business.Menu
reference_type: package
---

# clsMenuItemCollection

Loads and filters menu items.

## Purpose
- Provide the maintenance set of menu items.
- Offer predicate-based filtering after retrieval.

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

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| Item (default, keyed) | `Default Public Overloads ReadOnly Property Item(ByVal inMenuItemSeqNum As Decimal) As clsMenuItem` | Looks up a menu item in the loaded collection by its `MenuItemSeqNum` key, returning `Nothing` if no item matches. |
| CurrentItem | `Public Shadows ReadOnly Property CurrentItem() As clsMenuItem` | Returns the base collection's current item cast to `clsMenuItem`, avoiding caller-side casting when navigating the loaded menu-item set. |
| Save | `Public Overrides Function Save() As Boolean` | Persists the current object state through the SAIF data-portal lifecycle. |
| Add | `Public Shadows Function Add(ByVal inclsMenuItem As clsMenuItem) As Integer` | Appends an already-constructed row to the in-memory collection so it participates in the next `Save()` and any collection-wide iteration, without issuing a retrieve. |
| Contains | `Public Overloads Function Contains(ByVal inclsMenuItem As clsMenuItem) As Boolean` | Scans the loaded collection for an item whose `MenuItemSeqNum` equals the supplied object's `MenuItemSeqNum` (`clsMenuItem.Equals` compares only that sequence-number field). |
| Contains | `Public Overloads Function Contains(ByVal inMenuItemSeqNum As Decimal) As Boolean` | Scans the loaded collection for an item whose `MenuItemSeqNum` property equals the supplied value. |
| ContainsDeleted | `Public Overloads Function ContainsDeleted(ByVal inclsMenuItem As clsMenuItem) As Boolean` | Scans the deleted-items list for an entry whose `MenuItemSeqNum` equals the supplied object's `MenuItemSeqNum`. |
| ContainsDeleted | `Public Overloads Function ContainsDeleted(ByVal inMenuItemSeqNum As Decimal) As Boolean` | Scans the deleted-items list for an entry matching the supplied sequence number, via `clsMenuItem.Equals(Object)`. |
| Remove | `Public Overloads Sub Remove(ByVal inMenuItemSeqNum As Decimal)` | Removes the menu item matching the supplied key from the in-memory collection and moves it to the inherited deleted-items list so a subsequent `Save()` still issues the delete statement. |
| Where | `Public Function Where(ByVal match As Predicate(Of clsMenuItem)) As clsMenuItemCollection` | Returns a filtered typed subset of the loaded collection. |
| NewMenuItems | `Public Shared Function NewMenuItems(ByVal inDataportal As IDataPortalInfo) As clsMenuItemCollection` | Creates a new typed object using the supplied data-portal context. |
| GetAllMenuItems | `Public Shared Function GetAllMenuItems(ByVal inDataportal As IDataPortalInfo) As clsMenuItemCollection` | Retrieves the full typed set from Oracle. |

## Behavioral notes
- Authorization is handled elsewhere by `clsMenuAuthorizedItemCollection`.

## Constraints and usage notes
- Collection wrapper around menu items.

## Inherited public members

No `dependency-resolution.json` was produced for this run, so the members below are a best-effort inference from typical SAIF BOF framework (`clsBusinessCollection(Of T)`) patterns observed elsewhere in this codebase, not a Legends CLI-sourced dependency lookup.**

### From clsBusinessCollection(Of clsMenuItem) (SAIF.BOF.Framework)**

| Member | Signature | Purpose | Origin |
| --- | --- | --- | --- |
| Count | `Public ReadOnly Property Count() As Integer` | *Purpose could not be verified beyond the standard collection-indexer contract**; inferred usage is bounding `For` loops when callers iterate loaded `clsMenuItem` rows outside `GetEnumerator`. | `clsBusinessCollection(Of T)` |
| Item | `Public Default ReadOnly Property Item(ByVal index As Integer) As clsMenuItem` | *Purpose could not be verified beyond the standard collection-indexer contract**; inferred usage is positional access to a loaded `clsMenuItem` row during indexed iteration or lookup-by-slot. | `clsBusinessCollection(Of T)` |
| GetEnumerator | `Public Function GetEnumerator() As IEnumerator(Of clsMenuItem)` | Supports `For Each` iteration over the loaded collection.** | `clsBusinessCollection(Of T)` |
| IsDirty | `Public Overridable ReadOnly Property IsDirty() As Boolean` | Reports whether any loaded or deleted item in the collection has pending changes.** | `clsBusinessCollection(Of T)` |
| IsValid | `Public Overridable ReadOnly Property IsValid() As Boolean` | Reports whether every loaded item in the collection independently reports itself valid.** | `clsBusinessCollection(Of T)` |

> **Note:** Statements marked with `**` could not be confirmed; treat
> as unknown until verified.

## Sources
- `SAIF.Business.Menu\clsMenuItemCollection.vb`