Revit 2025 API
RebarCreate |
Creates a free form rebar that will be unconstrained. Constraints can't be added later to this rebar.
Namespace: Autodesk.Revit.DB.Structure
Assembly: RevitAPI (in RevitAPI.dll) Version: 25.0.0.0 (25.0.0.0)
Syntax
public static Rebar CreateFreeForm( Document doc, RebarBarType barType, Element host, IList<CurveLoop> curves, out RebarFreeFormValidationResult error )
Public Shared Function CreateFreeForm ( doc As Document, barType As RebarBarType, host As Element, curves As IList(Of CurveLoop), <OutAttribute> ByRef error As RebarFreeFormValidationResult ) As Rebar
public: static Rebar^ CreateFreeForm( Document^ doc, RebarBarType^ barType, Element^ host, IList<CurveLoop^>^ curves, [OutAttribute] RebarFreeFormValidationResult% error )
static member CreateFreeForm : doc : Document * barType : RebarBarType * host : Element * curves : IList<CurveLoop> * error : RebarFreeFormValidationResult byref -> Rebar
Parameters
- doc Document
- A document.
- barType RebarBarType
- A RebarBarType element that defines bar diameter, bend radius and material of the rebar.
- host Element
- The element to which the rebar belongs. The element must support rebar hosting.
- curves IListCurveLoop
- Each curve loop represents a bar in the set.
- error RebarFreeFormValidationResult
- Will be Success(0) if everything is ok, otherwise the failure reason.
Return Value
RebarThe newly created free form Rebar Instance.

Exception | Condition |
---|---|
ArgumentException | host is not a valid rebar host. |
ArgumentNullException | A non-optional argument was null |
ArgumentOutOfRangeException | A value passed for an enumeration argument is not a member of that enumeration |

The created rebar will have curves.Count bars. The layout will be Single if curves.Count is 1, otherwise will be Fixed Number and will not be changeable.
Setting a new list of curves will only change the number of bars in set.
This function can fail due to following reasons:
- The array of CurveLoops is empty.
- At least one CurveLoop is empty.
- At least one CurveLoop contains an unbounded curve.
- A rebar constructed from curves can't be bent according to the bending radius.
See Also