Get Started - Convert Distances and Lengths

• Sep 19, 2023
• 2 minutes to read

Important

You need a license for the DevExpress Office File API Subscription or DevExpress Universal Subscription to use these examples in production code.

This article describes how to get started with the unit conversion component for .NET Framework and .NET Core.

Create a .NET Framework Application

1. Start Microsoft Visual Studio and create a new Windows Forms App (.NET Framework) project.

2. Right-click the References node in the Solution Explorer and select Add Reference. In the invoked Reference Manager dialog, add a reference to the DevExpress.Docs.v24.1.dll assembly.

3. Drop a Button from the Toolbox onto the form.

4. Double click the button. Add the following code to the button’s Click event handler.

   C#

   using DevExpress.UnitConversion;
   //...
   // The height is 5'4".
   QuantityValue<Distance> height = (5.0).Feet() + (4.0).Inches();
   string s = String.Format("The height is {0} ells or {1} meters.",
       height.ToElls().Value.ToString("g3"), height.ToMeters().Value.ToString("g3"));
   MessageBox.Show(s);
   

   VB.NET

   Imports DevExpress.UnitConversion
   '...
   ' The height is 5'4".
   Private height As QuantityValue(Of Distance) = (5.0).Feet() + (4.0).Inches()
   Private s As String = String.Format("The height is {0} ells or {1} meters.", _
      height.ToElls().Value.ToString("g3"), height.ToMeters().Value.ToString("g3"))
   MessageBox.Show(s)
   

5. Run the project and click the button.

   

Create a .NET Core Application

1. Start Microsoft Visual Studio and create a new Console Application (.NET Core) project.

2. Install the DevExpress.Document.Processor NuGet package.

3. Paste the code below in the Main method of the Program.cs file (Main procedure of the Module1.vb file for Visual Basic).

   C#

   using DevExpress.UnitConversion;
   // ...
   
   QuantityValue<Distance> height = (5.0).Feet() + (4.0).Inches();
   string s = String.Format("The height is {0} ells or {1} meters.",
   height.ToElls().Value.ToString("g3"), height.ToMeters().Value.ToString("g3"));
   Console.WriteLine(s);
   

   VB.NET

   Imports DevExpress.UnitConversion
   ' ...
   
   Dim height As QuantityValue(Of Distance) = (5.0).Feet() + (4.0).Inches()
   Dim s As String = String.Format("The height is {0} ells or {1} meters.", height.ToElls().Value.ToString("g3"), height.ToMeters().Value.ToString("g3"))
   Console.WriteLine(s)
   

4. Run the project.