---
title: SAIFAlphaNumericLinkControl
summary: API reference for SAIFAlphaNumericLinkControl.
status: draft
owner: SAIF Documentation Team
last_reviewed: 2026-08-17
library: SAIF.Presentation.Web.Controls.V2
reference_type: package
---

# SAIFAlphaNumericLinkControl

`SAIFAlphaNumericLinkControl` generates a row of 27 `SAIFLinkButton` link controls (A–Z plus a combined "0-9" numeric link), commonly used as an alphabetical index/jump bar above a list or grid.

## Purpose
- Provide a ready-made alphabet index bar so consuming pages do not need to hand-build 27 link controls and their click wiring.
- Surface a single unified click event (`LinkClicked`) identifying which letter/number range was clicked, regardless of which of the 27 generated links triggered it.

## Context
- Namespace: `SAIF.Presentation.Web.Controls.V2`
- Assembly/package: Compiled into `SAIF.BOF.Presentation.Web.Infragistics103`*

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| `LinkClicked` | `Public Event LinkClicked(Value As AlphaNumericCharacter)` | Raised when any generated letter/number link is clicked, passing the corresponding `AlphaNumericCharacter` value so host pages can filter their data accordingly. |

## Inherited public members

`SAIFAlphaNumericLinkControl` inherits from `WebControl` (`System.Web.UI.WebControls`), a framework base class rather than a documented SAIF dependency library.

| Member | Signature | Purpose |
| --- | --- | --- |
| `AccessKey` | `Public Property AccessKey As String` | Keyboard shortcut character used to move focus to the rendered link-bar container. |
| `Attributes` | `Public ReadOnly Property Attributes As AttributeCollection` | Collection of arbitrary HTML attributes rendered on the control's outer tag. |
| `BackColor` | `Public Property BackColor As Color` | Background color applied to the rendered outer element. |
| `ForeColor` | `Public Property ForeColor As Color` | Foreground (text) color applied to the rendered outer element. |
| `BorderColor` | `Public Property BorderColor As Color` | Border color applied to the rendered outer element. |
| `BorderStyle` | `Public Property BorderStyle As BorderStyle` | Border line style applied to the rendered outer element. |
| `BorderWidth` | `Public Property BorderWidth As Unit` | Border width applied to the rendered outer element. |
| `CssClass` | `Public Property CssClass As String` | CSS class name(s) rendered on the control's outer tag. |
| `Enabled` | `Public Property Enabled As Boolean` | Controls whether the generated link controls participate in enabled-state behavior. |
| `Font` | `Public ReadOnly Property Font As FontInfo` | Font styling applied to the rendered outer element. |
| `Height` | `Public Property Height As Unit` | Height of the rendered outer element. |
| `Width` | `Public Property Width As Unit` | Width of the rendered outer element. |
| `Style` | `Public ReadOnly Property Style As CssStyleCollection` | Inline CSS style declarations rendered on the outer tag. |
| `ToolTip` | `Public Property ToolTip As String` | Text shown as a native tooltip when hovering the rendered element. |

Standard `WebControl`/`Control` members (`ID`, `ClientID`, `Controls`, `Visible`, `DataBind`, `FindControl`, etc.) are not re-documented here as they are unmodified framework behavior**.

## Behavioral notes
- `CreateChildControls` generates 26 `SAIFLinkButton` controls (`A`–`Z`, mapped from character codes 65–90) plus one additional link labeled `"0-9"` with `Value = AlphaNumericCharacter.Number`.
- Each generated link's `Click` event is wired to a private handler that re-raises the public `LinkClicked` event with the clicked link's `Value`.

## Constraints and usage notes
- All 27 links post back individually; consuming pages must handle `LinkClicked` to filter or navigate based on the received `AlphaNumericCharacter`.


> **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.Presentation.Web.Controls.V2\SAIFAlphaNumericLinkControl.vb