---
title: clsAppErrorCollection.Criteria
summary: API reference for clsAppErrorCollection.Criteria.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-07-24
library: SAIF.Application.LogView
reference_type: package
---

# clsAppErrorCollection.Criteria

`clsAppErrorCollection.Criteria` defines the public filter, sort, and search members used to retrieve `App_Error` collection results.

## Purpose
- Capture filter and ordering values for `App_Error` searches.
- Normalize full-text search input before SQL binding.

## Context
- Namespace: `SAIF.Application.LogView`
- Assembly/package: `SAIF.Application.LogView`

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| `AppName` | `Public Property AppName() As String` | Stores the application-name filter. |
| `EndDate` | `Public Property EndDate() As Date` | Stores the end date for a date-range filter. |
| `Environment` | `Public Property Environment() As String` | Stores the environment filter. |
| `ErrorDate` | `Public Property ErrorDate() As Date` | Stores the single-date filter. |
| `IsDirty` | `Public Property IsDirty() As Boolean` | Tracks whether criteria values have changed. |
| `MachineName` | `Public Property MachineName() As String` | Stores the machine-name filter. |
| `OrderByField` | `Public Property OrderByField() As String` | Stores the requested sort field name. |
| `OrderByDir` | `Public Property OrderByDir() As ComponentModel.ListSortDirection` | Stores the requested sort direction. |
| `SearchText` | `Public Property SearchText() As String` | Stores the free-text search input. |
| `SortableFields` | `Public ReadOnly Property SortableFields() As Dictionary(Of String, String)` | Returns the field-name map used when building the `ORDER BY` clause. |
| `StartDate` | `Public Property StartDate() As Date` | Stores the start date for a date-range filter. |
| `UserName` | `Public Property UserName() As String` | Stores the user-name filter. |
| `New` | `Public Sub New(ByVal inDataportal As IDataPortalInfo)` | Creates criteria bound to a data-portal instance. |
| `GetSearchValue` | `Public Function GetSearchValue() As String` | Converts `SearchText` into the value bound to `@SEARCHTEXT`. |

## Behavioral notes
- `GetSearchValue()` preserves the explicit operators `AND`, `OR`, `&`, `|`, and `&!`, which aligns with [BR-004](../../business-rules.md#br-004-search-text-is-normalized-for-full-text-queries).
- `OrderByField` is translated through `SortableFields` before `BuildOrder()` emits SQL.
- `Environment` and `UserName` support semicolon-delimited multi-value input, which aligns with [BR-003](../../business-rules.md#br-003-semicolon-delimited-filters-expand-to-sql-in-lists).

## Constraints and usage notes
- The SQL-property members and the date-specific overload constructor are `Friend` in source and are not part of the public API surface.

## Sources
- `Application\SAIF.Application.LogView\clsAppErrorCollection.vb`