Gapotchenko.FX.Versioning 2026.5.3

Overview

The module provides functionality for working with versions.

VersionTypeConverter

VersionTypeConverter class provides a type converter for System.Version that enables conversion to and from string representations and integration with various .NET components.

Using VersionTypeConverter

The VersionTypeConverter can be used with TypeDescriptor to convert between Version and string:

using Gapotchenko.FX.Versioning;
using System.ComponentModel;

var converter = TypeDescriptor.GetConverter(typeof(Version));
var version = (Version)converter.ConvertFrom("1.2.3.4");
Console.WriteLine(version); // "1.2.3.4"

Registering VersionTypeConverter

To ensure that VersionTypeConverter is used as the default converter for Version type, you can register it:

using Gapotchenko.FX.Versioning;

VersionTypeConverter.Register();

After registration, the converter will be automatically used by frameworks that rely on TypeDescriptor for type conversion, such as Windows Forms, WPF, and ASP.NET Core. Register method can be safely called multiple times; the actual registration occurs only once.

Version Deconstruction

The module provides extension methods that enable deconstruction of Version objects, allowing you to easily extract version components using pattern matching syntax.

Deconstructing to Major and Minor

using Gapotchenko.FX.Versioning;
using System;

var version = new Version(1, 2, 3, 4);
var (major, minor) = version;

Console.WriteLine($"Major: {major}, Minor: {minor}"); // "Major: 1, Minor: 2"

Deconstructing to Major, Minor, and Build

using Gapotchenko.FX.Versioning;
using System;

var version = new Version(1, 2, 3, 4);
var (major, minor, build) = version;

Console.WriteLine($"Major: {major}, Minor: {minor}, Build: {build}"); // "Major: 1, Minor: 2, Build: 3"

Deconstructing to All Components

using Gapotchenko.FX.Versioning;
using System;

var version = new Version(1, 2, 3, 4);
var (major, minor, build, revision) = version;

Console.WriteLine($"Version: {major}.{minor}.{build}.{revision}"); // "Version: 1.2.3.4"

Deconstruction is particularly useful when working with pattern matching:

using Gapotchenko.FX.Versioning;
using System;

Version GetVersion() => new Version(2, 0, 0, 0);

var (major, minor, _, _) = GetVersion();

if (major >= 2)
{
    Console.WriteLine("Version 2.0 or later");
}

Other Modules

Let's continue with a look at some other modules provided by Gapotchenko.FX:

• Gapotchenko.FX
• Gapotchenko.FX.AppModel.Information
• Gapotchenko.FX.Collections
• Gapotchenko.FX.Console
• Gapotchenko.FX.Data
• Gapotchenko.FX.Diagnostics
• Gapotchenko.FX.IO
• Gapotchenko.FX.Linq
• Gapotchenko.FX.Math
• Gapotchenko.FX.Memory
• Gapotchenko.FX.Security.Cryptography
• Gapotchenko.FX.Text
• Gapotchenko.FX.Threading
• Gapotchenko.FX.Tuples
• ➴ Gapotchenko.FX.Versioning
  • Gapotchenko.FX.Versioning.Semantic

Or look at the full list of modules.