Share

UnitFormatUtils.Format(Units, ForgeTypeId, Double, Boolean) Method

Formats a number with units into a string.


Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 26.1.0.0 (26.1.0.34)

Syntax

C#

public static string Format(
	Units units,
	ForgeTypeId specTypeId,
	double value,
	bool forEditing
)

Parameters

units  Units
The units formatting settings, typically obtained from Document.GetUnits().
specTypeId  ForgeTypeId
Identifier of the spec of the value to format.
value  Double
The value to format, in Revit's internal units.
forEditing  Boolean
True if the formatting should be modified as necessary so that the formatted string can be successfully parsed, for example by suppressing digit grouping. False if unmodified settings should be used, suitable for display only.

Return Value

String
The formatted string.

Exceptions

ExceptionCondition
ArgumentException specTypeId is not a measurable spec identifier. See UnitUtils.IsMeasurableSpec(ForgeTypeId). -or- The given value for value is not finite
ArgumentNullException A non-optional argument was null

See Also

Reference

Was this information helpful?