CoreSuite.NumericBoxBase 1.0.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package CoreSuite.NumericBoxBase --version 1.0.0
                    


                    

                
NuGet\Install-Package CoreSuite.NumericBoxBase -Version 1.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="CoreSuite.NumericBoxBase" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="CoreSuite.NumericBoxBase" Version="1.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="CoreSuite.NumericBoxBase" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add CoreSuite.NumericBoxBase --version 1.0.0
                    


                    

                
#r "nuget: CoreSuite.NumericBoxBase, 1.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package CoreSuite.NumericBoxBase@1.0.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=CoreSuite.NumericBoxBase&version=1.0.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=CoreSuite.NumericBoxBase&version=1.0.0
                    


                            Install as a Cake Tool

NumericBoxBase

Abstract foundation for culture-aware numeric text controls.

NumericBoxBase is one of the controls or components included in the CoreSuite solution. The package has no additional CoreSuite package dependencies.

Overview

NumericBoxBase extends TextBox and provides abstract foundation for culture-aware numeric text controls.

It is designed for .NET 8 Windows Forms applications and can be configured in code or through the Visual Studio designer where designer support applies.

Features

  • Fractional digit count.
  • Digit grouping option.
  • Parsing and formatting culture.
  • Midpoint rounding strategy.
  • Uses the standard Windows Forms event and component model.
  • Includes English XML documentation for the public API.
  • Requires no third-party packages.

Requirements

  • Windows Forms
  • .NET 8 for Windows (net8.0-windows)

This is an infrastructure package used by DecimalBox, CurrencyBox and PercentageBox. Install a derived package unless you are creating a custom numeric control.

Installation

Install the package from NuGet:

dotnet add package CoreSuite.NumericBoxBase

Or use the Visual Studio NuGet Package Manager and search for:

CoreSuite.NumericBoxBase

Namespace

Imports CoreSuite.Controls

Quick start

Imports CoreSuite.Controls

Public Class MeasurementBox
    Inherits NumericBoxBase

    Protected Overrides Function FormatNumericValueForDisplay(Value As Decimal) As String
        Return Value.ToString($"N{DecimalPlaces}", NumericCulture) & " cm"
    End Function
End Class

Creating a derived control

The base class is not intended to be placed directly on a form. Inherit from it when implementing a specialized CoreSuite input control.

API reference

NumericBoxBase

Represents abstract foundation for culture-aware numeric text controls.

Public MustInherit Class NumericBoxBase
    Inherits TextBox

Main members

Member Behavior
DecimalPlaces fractional digit count.
IncludeThousandSeparator digit grouping option.
NumericCulture parsing and formatting culture.
RoundingMode midpoint rounding strategy.
SetNumericValue() changes the value from a derived control.
RefreshNumericText() reapplies display formatting.
FormatNumericValueForDisplay() required display implementation.
TryParseNumericValue(), NormalizeNumericValue() and OnNumericValueChanged() extension points.

Behavior and validation

  • Property changes take effect immediately unless a method explicitly starts or applies an operation.
  • Callers should validate user input and referenced objects before performing application-specific work.
  • Events use the standard Windows Forms event model and should be handled on the UI thread.

Standard functionality

Because NumericBoxBase inherits from TextBox, the standard public members of that base type remain available unless the control intentionally hides or overrides them.

Resource and lifetime considerations

  • Dispose components, controls, images, fonts and menus created dynamically when your application owns them.
  • Keep referenced controls alive for as long as a component is attached to them.
  • File-based operations should receive valid, accessible paths.

Package information

Item Value
Package CoreSuite.NumericBoxBase
Namespace CoreSuite.Controls
Assembly CoreSuite.NumericBoxBase
Target framework net8.0-windows
UI framework Windows Forms
CoreSuite dependencies None
External dependencies None

License

This package is distributed under the MIT License defined by the CoreSuite repository.

Product Compatible and additional computed target framework versions.
.NET net8.0-windows7.0 is compatible.  net9.0-windows was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • net8.0-windows7.0

    • No dependencies.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on CoreSuite.NumericBoxBase:

Package Downloads
CoreSuite.DecimalBox

A culture-aware Windows Forms decimal input control with configurable precision and grouping.
CoreSuite.PercentageBox

A culture-aware Windows Forms percentage input control with configurable precision and formatting.
CoreSuite.CurrencyBox

A culture-aware Windows Forms currency input control with configurable decimal places, grouping and value formatting.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0 118 8/2/2026

Initial release of the NumericBoxBase base control.