Autodesk.Revit.DB.UnitFormatUtils技术文档

Autodesk.Revit.DB.UnitFormatUtils是一个用于格式化测量单位的工具类，通过使用该类中的方法，可以将Revit中的测量单位转换为对应格式的字符串。

方法

GetUnitSymbol()

该方法用于获取指定测量单位的符号字符串。

参数

• UnitType: 测量单位类型枚举类型。支持的枚举类型有Length、Area、Volume、Angle、Mass、Force、Pressure、Density、Temperature、LinearVelocity、AngularVelocity、Acceleration、HeatFluxDensity、HeatTransferCoefficient、ThermalResistance、SpecificHeatCapacity、ThermalConductivity、ElectricCurrent、ElectricalVoltage、ElectricalPower、LuminousFlux、Illuminance、LuminousIntensity、RadiationDoseRate、RadiationExposure、CatalyticActivity、DoseEquivalent、ElectricCharge、ElectricResistance、ElectricCapacitance、Inductance、MagneticFlux、MagneticFluxDensity、Radiance、SolidAngle、Time。
• displayUnitType: 表示输出字符串的格式类型。支持的类型有Metric、Scientific、Decimal、Fractional、ArcDegrees、Surveyor、Inches、Feet、Meters。

返回值

类型为String，表示指定测量单位的符号字符串。

Format()

该方法用于将给定的数值和测量单位格式化为字符串。

参数

• value: 表示要格式化的数值。可以为int、float、decimal等类型。
• UnitType: 测量单位类型枚举类型。具体类型参见GetUnitSymbol()方法的参数说明。
• displayUnitType: 表示输出字符串的格式类型。具体类型参见GetUnitSymbol()方法的参数说明。

返回值

类型为String，表示格式化后的字符串。

示例代码

using Autodesk.Revit.DB;

double lengthValue = 10.0;
UnitType unitType = UnitType.UT_Length;
string lengthSymbol = UnitFormatUtils.GetUnitSymbol(unitType, DisplayUnitType.DUT_METERS);
string formattedLength = UnitFormatUtils.Format(lengthValue, unitType, DisplayUnitType.DUT_METERS);

Console.WriteLine($"Length value: {lengthValue}");
Console.WriteLine($"Length symbol: {lengthSymbol}");
Console.WriteLine($"Formatted length: {formattedLength}");

输出结果为：

Length value: 10
Length symbol: m
Formatted length: 10.00 m

以上示例代码展示了如何使用Autodesk.Revit.DB.UnitFormatUtils类的方法GetUnitSymbol()及Format()对长度值进行格式化。

注意事项

当使用UnitFormatUtils.Format()方法将数值格式化为字符串时，如果数值与测量单位不能匹配，将抛出异常。因此，在进行格式化之前建议先检查数值与测量单位是否匹配。