Creates a new instance of a Rebar Coupler element within the project.

Namespace: Autodesk.Revit.DB.Structure
Assembly: RevitAPI (in RevitAPI.dll) Version: 22.0.0.0 (22.1.0.0)
Since: 2017

Syntax

C#
`public static RebarCoupler Create( Document doc, ElementId typeId, ReinforcementData pFirstData, ReinforcementData pSecondData, out RebarCouplerError error )`

Visual Basic

Visual Basic
`Public Shared Function Create ( _ doc As Document, _ typeId As ElementId, _ pFirstData As ReinforcementData, _ pSecondData As ReinforcementData, _ <OutAttribute> ByRef error As RebarCouplerError _ ) As RebarCoupler`

Public Shared Function Create ( _
	doc As Document, _
	typeId As ElementId, _
	pFirstData As ReinforcementData, _
	pSecondData As ReinforcementData, _
	<OutAttribute> ByRef error As RebarCouplerError _
) As RebarCoupler

Visual C++
`public: static RebarCoupler^ Create( Document^ doc, ElementId^ typeId, ReinforcementData^ pFirstData, ReinforcementData^ pSecondData, [OutAttribute] RebarCouplerError% error )`

Parameters

doc: Type: Autodesk.Revit.DB Document
A document.

typeId: Type: Autodesk.Revit.DB ElementId
type id for coupler

pFirstData: Type: Autodesk.Revit.DB.Structure ReinforcementData
information about the first reinforcement to be coupled

pSecondData: Type: Autodesk.Revit.DB.Structure ReinforcementData
information about the second reinforcement to be coupled; if a nullptr is passed in the coupler is placed on one reinforcement

error: Type: Autodesk.Revit.DB.Structure RebarCouplerError %
will be ValidationSuccesfully(0) if ok, otherwise the failure reason

Return Value

The newly created Rebar Coupler instance, or a null reference ( Nothing in Visual Basic) if the operation fails.

Exceptions

Exception	Condition
Autodesk.Revit.Exceptions ArgumentNullException	A non-optional argument was null
Autodesk.Revit.Exceptions ArgumentOutOfRangeException	A value passed for an enumeration argument is not a member of that enumeration

Create Method

Syntax

Parameters

Return Value

Exceptions

See Also

Put AI to work inside Revit.