---
title: BinaryConverter
summary: API reference for BinaryConverter.
status: draft
owner: <owner>
last_reviewed: 2026-07-23
library: SAIF.Framework.BaseN
reference_type: package
---

# BinaryConverter

`BinaryConverter` is a concrete `ConverterBase` subclass that represents base 2 (binary). It overrides only the `Base` property and relies entirely on `ConverterBase`'s default digit-conversion and formatting logic.

## Purpose
- Provide an `IConverter` implementation for binary (base 2) numeric conversion.

## Context
- Namespace: `SAIF.Framework.BaseN`
- Assembly/package: `SAIF.Framework.BaseN` (also bundled into the `SAIF.BOF.Framework` NuGet package)

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| `Base` | `Public Overrides ReadOnly Property Base() As Integer` | Returns `2`. |

## Inherited public members

Members in this section are inherited from `ConverterBase` in `SAIF.Framework.BaseN`. They are available on this type through inheritance.

| Member | Signature | Purpose | Origin |
| --- | --- | --- | --- |
| `ConvertAlphaToNumeric` | `Public Overridable Function ConvertAlphaToNumeric(ByVal input As String) As Integer` | Default: returns `CInt(input)` if numeric, else `0` ([BR-004](../../business-rules.md#br-004-non-numeric-input-to-the-default-alpha-to-numeric-conversion-is-treated-as-zero)). | `SAIF.Framework.BaseN` — `ConverterBase` |
| `ConvertNumericToAlpha` | `Public Overridable Function ConvertNumericToAlpha(ByVal input As Integer) As String` | Default: returns `input.ToString()`. | `SAIF.Framework.BaseN` — `ConverterBase` |
| `FormatBaseN` | `Public Overridable Function FormatBaseN(ByVal values As Integer()) As String` | Default: renders a digit array right-to-left as a string. | `SAIF.Framework.BaseN` — `ConverterBase` |

## Behavioral notes
- Because `BinaryConverter` does not override `ConvertAlphaToNumeric`, non-numeric input is silently treated as `0` rather than raising an error ([BR-004](../../business-rules.md#br-004-non-numeric-input-to-the-default-alpha-to-numeric-conversion-is-treated-as-zero)).

## Constraints and usage notes
- No bounds checking is performed on digit values for this converter; unlike `HexConverter`/`ExcelConverter`, `BinaryConverter` does not throw `ConverterException`.*

> **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. Statements marked with
> † were retrieved from dependency library documentation via the Legends CLI RAG service. They
> describe inherited behavior from the indicated origin library and should be verified if the
> dependency version changes.

## Sources
- `SAIF.Framework.BaseN\BinaryConverter.vb`
- `SAIF.Framework.BaseN\ConverterBase.vb`