--- title: SAIF.NetCore.Common API reference summary: Index of all public types in this library. status: draft owner: Framework.NCore maintainers last_reviewed: 2026-10-02 library: SAIF.NetCore.Common reference_type: package --- # SAIF.NetCore.Common API reference This page lists all public types exposed by `SAIF.NetCore.Common`. Each type links to its full API reference page. ## Types | Type | Kind | Namespace | Purpose | | --- | --- | --- | --- | | [BooleanExtensions](SAIF.NetCore.Common.Extensions/BooleanExtensions.md) | Class | `SAIF.NetCore.Common.Extensions` | Provide a single, consistent set of boolean-to-text conversions (`Y`/`N`, `YES`/`NO`, `On`/`Off`) so consuming code never hand-rolls its own mapping. | | [ByteExtensions](SAIF.NetCore.Common.Extensions/ByteExtensions.md) | Class | `SAIF.NetCore.Common.Extensions` | Locate a byte or ASCII-text pattern inside a byte array with an optional search-window limit. | | [ContextException](SAIF.NetCore.Common.Types/ContextException.md) | Class | `SAIF.NetCore.Common.Types` | Provide a shared `TargetView`/`Model` shape for the four concrete context-exception subclasses so consuming MVC applications can catch `ContextException` once and read a view name regardless of the specific failure. | | [ContiguousOptions](SAIF.NetCore.Common.Enums/ContiguousOptions.md) | Enum | `SAIF.NetCore.Common.Enums` | Offer a `ContiguousOptions` contract for callers that reference `SAIF.NetCore.Common.Enums` without also referencing `SAIF.NetCore.Common.Extensions`. | | [DateExtensions](SAIF.NetCore.Common.Extensions/DateExtensions.md) | Class | `SAIF.NetCore.Common.Extensions` | Classify a `DateTime` as the current date, a future date, a past date, or a sentinel `MinValue`/`MaxValue`. | | [DateMaker](SAIF.NetCore.Common.Helpers/DateMaker.md) | Class | `SAIF.NetCore.Common.Helpers` | Parse an EDI-format date string (with an assumed 2000s century for 2-digit years) and an optional time string into a `DateTime`. | | [DateRange](SAIF.NetCore.Common.Types/DateRange.md) | Class | `SAIF.NetCore.Common.Types` | Represent a begin/end date pair with `DateTime.MinValue`/`MaxValue` sentinels for "no date"/open-ended ranges. | | [DateRangeExtensions](SAIF.NetCore.Common.Extensions/DateRangeExtensions.md) | Class | `SAIF.NetCore.Common.Extensions` | Determine whether a single `DateRange` is valid, open-ended, in the future, or in the past. | | [DateRangeExtensions.ContiguousOptions](SAIF.NetCore.Common.Extensions/DateRangeExtensions.ContiguousOptions.md) | Enum | `SAIF.NetCore.Common.Extensions` | Supply the three contiguity policies (`StartMatchesEnd`, `StartIsNextDay`, `AllowGaps`) consumed by `DateRangeExtensions.IsContiguous`. | | [DateRangeExtensions.OverlappingOptions](SAIF.NetCore.Common.Extensions/DateRangeExtensions.OverlappingOptions.md) | Enum | `SAIF.NetCore.Common.Extensions` | Supply the two overlap-boundary policies (`DatesMayMatch`, `DatesMayNotMatch`) consumed by `DateRangeExtensions.IsOverLapping(IEnumerable)`. | | [DateRangeOverlapResult](SAIF.NetCore.Common.Enums/DateRangeOverlapResult.md) | Enum | `SAIF.NetCore.Common.Enums` | Give `NullableDateRange.GetOverlapState` a precise vocabulary for describing how range A and range B relate (no overlap, neither range ends, or one of eight compound begin/end relationship patterns). | | [DictionaryExtensions](SAIF.NetCore.Common.Extensions/DictionaryExtensions.md) | Class | `SAIF.NetCore.Common.Extensions` | Merge two string-keyed dictionaries into one, with a caller-controlled policy for resolving key collisions. | | [DisabledViewException](SAIF.NetCore.Common.Types/DisabledViewException.md) | Class | `SAIF.NetCore.Common.Types` | Signal, via a typed exception, that a requested view is currently disabled, optionally carrying a model for the consumer's disabled-view display. | | [Enforce](SAIF.NetCore.Common.Helpers/Enforce.md) | Class | `SAIF.NetCore.Common.Helpers` | Throw `ArgumentNullException` for a null required argument. | | [EntityBase](SAIF.NetCore.Common.Types/EntityBase.md) | Class | `SAIF.NetCore.Common.Types` | Reserve a generic base-class slot named `EntityBase` for a future entity abstraction; currently provides no behavior.* | | [ExceptionExtensions](SAIF.NetCore.Common.Extensions/ExceptionExtensions.md) | Class | `SAIF.NetCore.Common.Extensions` | Produce a full, multi-exception formatted report of an exception chain for diagnostic logging. | | [ExpressionExtensions](SAIF.NetCore.Common.Extensions/ExpressionExtensions.md) | Class | `SAIF.NetCore.Common.Extensions` | Resolve the `PropertyInfo` referenced by a strongly-typed property-access expression. | | [FileExtensions](SAIF.NetCore.Common.Extensions/FileExtensions.md) | Class | `SAIF.NetCore.Common.Extensions` | Read an entire `Stream` into a `byte[]` so callers can pass file or request content into this library's byte-array extension methods. | | [GenericExtensions](SAIF.NetCore.Common.Extensions/GenericExtensions.md) | Class | `SAIF.NetCore.Common.Extensions` | Throw a caller-chosen exception type when a value is null, as a terser alternative to writing an explicit `if (value == null)` null check followed by a `throw` statement. | | [IComparableExtensions](SAIF.NetCore.Common.Extensions/IComparableExtensions.md) | Class | `SAIF.NetCore.Common.Extensions` | Test whether a value falls between two boundary values, inclusively by default or under a caller-selected `IncludeComparisons` mode. | | [IEnumerableExtensions](SAIF.NetCore.Common.Extensions/IEnumerableExtensions.md) | Class | `SAIF.NetCore.Common.Extensions` | Iterate a sequence and apply a side-effecting action to each element (`ForEach`). | | [IncludeComparisons](SAIF.NetCore.Common.Enums/IncludeComparisons.md) | Enum | `SAIF.NetCore.Common.Enums` | Offer an `IncludeComparisons` contract for callers that reference `SAIF.NetCore.Common.Enums` without also referencing `SAIF.NetCore.Common.Extensions`. | | [IncludeComparisons](SAIF.NetCore.Common.Extensions/IncludeComparisons.md) | Enum | `SAIF.NetCore.Common.Extensions` | Supply the four inclusive/exclusive boundary-comparison modes (`Inclusive`, `Exclusive`, `FirstOnly`, `LastOnly`) that `IComparableExtensions.IsBetween` and `DateRangeExtensions.IsInRange`/`AsOf` actually use at runtime. | | [InvalidContextException](SAIF.NetCore.Common.Types/InvalidContextException.md) | Class | `SAIF.NetCore.Common.Types` | Signal, via a typed exception, that the consuming application's current context failed validation. | | [InvalidContextForUserException](SAIF.NetCore.Common.Types/InvalidContextForUserException.md) | Class | `SAIF.NetCore.Common.Types` | Signal, via a typed exception, that the consuming application's current context is not valid for the current user, distinct from a generally invalid context. | | [Julian](SAIF.NetCore.Common.Helpers/Julian.md) | Class | `SAIF.NetCore.Common.Helpers` | Validate that a Julian value contains enough digits to be parsed. | | [LogType](SAIF.NetCore.Common.Enums/LogType.md) | Enum | `SAIF.NetCore.Common.Enums` | Provide consuming applications a shared enum with six named members (`File0`–`File4`, `Custom`); exact consumer semantics are unknown.** | | [LongSequence](SAIF.NetCore.Common.Types/LongSequence.md) | Class | `SAIF.NetCore.Common.Types` | Produce a strictly increasing sequence of `long` values starting from a caller-supplied value. | | [NoContextException](SAIF.NetCore.Common.Types/NoContextException.md) | Class | `SAIF.NetCore.Common.Types` | Signal, via a typed exception, that the consuming application attempted an operation with no context established. | | [NullableDateRange](SAIF.NetCore.Common.Types/NullableDateRange.md) | Class | `SAIF.NetCore.Common.Types` | Represent a date range whose end date may be genuinely absent (`null`) rather than using the `DateRange` sentinel convention of `DateTime.MaxValue`. | | [NumericExtensions](SAIF.NetCore.Common.Extensions/NumericExtensions.md) | Class | `SAIF.NetCore.Common.Extensions` | Detect whether a string represents a 32-bit integer value. | | [OverlappingDateOptions](SAIF.NetCore.Common.Enums/OverlappingDateOptions.md) | Enum | `SAIF.NetCore.Common.Enums` | Offer an `OverlappingDateOptions` contract for callers that reference `SAIF.NetCore.Common.Enums` without also referencing `SAIF.NetCore.Common.Extensions`. | | [Reflector](SAIF.NetCore.Common.Helpers/Reflector.md) | Class | `SAIF.NetCore.Common.Helpers` | Return the public property metadata for a generic type parameter. | | [SaifValidationException](SAIF.NetCore.Common.Types/SaifValidationException.md) | Class | `SAIF.NetCore.Common.Types` | Wrap a `ValidationResult` (or a single property/error-message pair) in a throwable exception. | | [SecurityPrincipalExtensions](SAIF.NetCore.Common.Extensions/SecurityPrincipalExtensions.md) | Class | `SAIF.NetCore.Common.Extensions` | Extract the user-name segment of a `DOMAIN\user` identity name. | | [Sequence](SAIF.NetCore.Common.Types/Sequence.md) | Class | `SAIF.NetCore.Common.Types` | Produce a strictly increasing sequence of `long` values starting from a caller-supplied `int` value. | | [SequenceGenerator](SAIF.NetCore.Common.Types/SequenceGenerator.md) | Class | `SAIF.NetCore.Common.Types` | Hold the generator's current value and expose it to subclasses via a protected setter. | | [StringExtensions](SAIF.NetCore.Common.Extensions/StringExtensions.md) | Class | `SAIF.NetCore.Common.Extensions` | Test a string for null, empty, or white-space content without repeating `string.IsNullOrEmpty`/`IsNullOrWhiteSpace` call sites. | | [UriExtensions](SAIF.NetCore.Common.Extensions/UriExtensions.md) | Class | `SAIF.NetCore.Common.Extensions` | Extract the top-level application-name segment from a `Uri`'s path. | | [ValidationFailure](SAIF.NetCore.Common.Types/ValidationFailure.md) | Class | `SAIF.NetCore.Common.Types` | Record one validation failure's property name, error message, and the value that failed validation, for later inspection or display. | | [ValidationResult](SAIF.NetCore.Common.Types/ValidationResult.md) | Class | `SAIF.NetCore.Common.Types` | Collect zero or more `ValidationFailure` entries and informational messages produced by a validation pass. | > **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 - `src/SAIF.NetCore.Common/SAIF.NetCore.Common/SAIF.NetCore.Common/SAIF.NetCore.Common.csproj`