Get Started - Convert Distances and Lengths

  • 2 minutes to read
IMPORTANT

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

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.v20.2.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.

    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);
    
  5. Run the project and click the button.

    units_getstarted

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).

    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);
    
  4. Run the project.

    result