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

# clsMenuSecurityUser

Owns one user-to-group membership row.

## Purpose
- Persist the groups that a user belongs to.
- Provide membership rows later joined during authorization.

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

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| MenuSecurityUserSeq | `Public Property MenuSecurityUserSeq() As Decimal` | Surrogate primary key of the `MENU_SECURITY_USER` row, used to target update/delete statements. |
| SecurityGroupTxt | `Public Property SecurityGroupTxt() As String` | Name of the security group this row grants the user membership in, matched case-insensitively when authorizing menu access ([BR-MENU-003](../../business-rules.md#br-menu-003-security-group-matching-is-case-insensitive)). |
| MenuUser | `Public Property MenuUser() As String` | Login of the user granted membership in `SecurityGroupTxt`, matched case-insensitively against `MENU_SECURITY.SECURITY_GROUP_TXT` during authorization ([BR-MENU-003](../../business-rules.md#br-menu-003-security-group-matching-is-case-insensitive)). |
| MenuUserID | `Public Property MenuUserID() As String` | Employee identifier of the user, stored alongside the login for audit/reporting. |
| IsValid | `Public Overrides ReadOnly Property IsValid() As Boolean` | Overrides `clsBusinessBase.IsValid`. `AddBusinessRules()` for this type contains only commented-out template placeholders, so no local Rules-engine field-level validation exists; the confirmed behavior is inherited from `clsBusinessBase`.* |
| IsDirty | `Public Overrides ReadOnly Property IsDirty() As Boolean` | Reports whether any of the membership row's own property values have changed since load, overriding the inherited `clsBusinessBase.IsDirty`. |
| SetMenuUserIDNull | `Public Sub SetMenuUserIDNull()` | Clears the underlying value so the corresponding column is persisted as `NULL` on the next save, instead of a real value. |
| IsMenuUserIDNull | `Public Function IsMenuUserIDNull() As Boolean` | Reports whether `MenuUserID` is unset, so callers can distinguish an absent employee identifier from an empty string. |
| Equals | `Public Overloads Shared Function Equals(ByVal objA As Object, ByVal objB As Object) As Boolean` | Compares business-object identity using this type's key semantics. |
| Equals | `Public Overloads Overrides Function Equals(ByVal inObject As Object) As Boolean` | Compares business-object identity using this type's key semantics. |
| Equals | `Public Overloads Function Equals(ByVal inObject As clsMenuSecurityUser) As Boolean` | Compares business-object identity using this type's key semantics. |
| GetHashCode | `Public Overrides Function GetHashCode() As Integer` | Returns a hash based on the type's business identity semantics. |
| ToString | `Public Overrides Function ToString() As String` | Returns the type's string representation for diagnostics or UI binding. |
| NewMenuSecurityUser | `Public Shared Function NewMenuSecurityUser(ByVal inDataportal As IDataPortalInfo, ByVal inSecurityGroupTxt As String, ByVal inMenuUser As String, ByVal inEmployeeID As String) As clsMenuSecurityUser` | Creates a new typed object using the supplied data-portal context. |

## Behavioral notes
- Contributes to [BR-MENU-003](../../business-rules.md#br-menu-003-security-group-matching-is-case-insensitive).

## Constraints and usage notes
- Stores login and employee identifiers.

## 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 (`clsBusinessBase`) patterns observed elsewhere in this codebase, not a Legends CLI-sourced dependency lookup.**

### From clsBusinessBase (SAIF.BOF.Framework)**

| Member | Signature | Purpose | Origin |
| --- | --- | --- | --- |
| Save | `Public Overridable Function Save() As Boolean` | Routes the object through the inherited data-portal lifecycle to persist it when dirty and valid.** | `clsBusinessBase` |
| Delete | `Public Overridable Sub Delete()` | Marks the object for deletion and, on `Save()`, routes it through `BeforeDelete`/`AfterDelete`.** | `clsBusinessBase` |
| AddErrorMessage | `Protected Sub AddErrorMessage(ByVal inKey As String, ByVal inMessage As String)` | Records a named validation/error message consulted by the inherited `IsValid` implementation.** | `clsBusinessBase` |
| MarkOld | `Protected Sub MarkOld()` | Clears the object's dirty flag after a successful load or save.** | `clsBusinessBase` |
| MarkNew | `Protected Sub MarkNew()` | Marks a freshly constructed object as new/dirty so `Save()` treats it as an insert candidate.** | `clsBusinessBase` |

> **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.

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