CoreSuite.DateTimeBoxBase 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.DateTimeBoxBase --version 1.0.0
                    


                    

                
NuGet\Install-Package CoreSuite.DateTimeBoxBase -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.DateTimeBoxBase" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="CoreSuite.DateTimeBoxBase" Version="1.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="CoreSuite.DateTimeBoxBase" />
                    


                            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.DateTimeBoxBase --version 1.0.0
                    


                    

                
#r "nuget: CoreSuite.DateTimeBoxBase, 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.DateTimeBoxBase@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.DateTimeBoxBase&version=1.0.0
                    


                            Install as a Cake Addin
                        

                    

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


                            Install as a Cake Tool

DateTimeBoxBase

Abstract base for culture-aware date and time text controls.

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

Overview

DateTimeBoxBase extends MaskedTextBox and provides abstract base for culture-aware date and time 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

  • Generated input mask (read-only).
  • Active culture (read-only).
  • Culture exposed to derived classes.
  • Format supplied by the derived class.
  • 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 DateBox and TimeBox. Install those packages for normal application use.

Installation

Install the package from NuGet:

dotnet add package CoreSuite.DateTimeBoxBase

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

CoreSuite.DateTimeBoxBase

Namespace

Imports CoreSuite.Controls

Quick start

Imports CoreSuite.Controls

Public Class CustomTemporalBox
    Inherits DateTimeBoxBase

    Protected Overrides ReadOnly Property ValueFormat As String
        Get
            Return "HH:mm"
        End Get
    End Property

    Protected Overrides Function CreateMask(Format As String) As String
        Return "00:00"
    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

DateTimeBoxBase

Represents abstract base for culture-aware date and time text controls.

Public MustInherit Class DateTimeBoxBase
    Inherits MaskedTextBox

Main members

Member Behavior
Mask generated input mask (read-only).
Culture active culture (read-only).
ValueCulture culture exposed to derived classes.
ValueFormat format supplied by the derived class.
SetTemporalValue() updates the internal value.
RefreshValueFormat() rebuilds mask and formatted text.
TryParseValue(), FormatValue() and NormalizeValue() extension points.
CreateMask() required mask-generation implementation.

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 DateTimeBoxBase inherits from MaskedTextBox, 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.DateTimeBoxBase
Namespace CoreSuite.Controls
Assembly CoreSuite.DateTimeBoxBase
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.DateTimeBoxBase:

Package Downloads
CoreSuite.DateTimeBox

Culture-aware WinForms date and time input control with masked entry, a combined calendar and time dropdown, and designer support.
CoreSuite.DateBox

A culture-aware Windows Forms date input control with masking, validation and a drop-down calendar.
CoreSuite.TimeBox

A culture-aware Windows Forms time input control with masking, validation and a drop-down time selector.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0 130 8/2/2026

Initial release of the DateTimeBoxBase base control.