M

Duct.Create

Description:
Creates a new duct that connects to two connectors.

Remarks:
The new duct will have the same diameter and system type as the start connector. The creation will also connect the new duct to two component who owns the specified connectors. If necessary, additional fitting(s) are included to make a valid connection. If the new duct can not be connected to the next component (e.g., mismatched direction, no valid fitting, and etc), the new duct will still be created at the specified connector position, and an InvalidOperationException is thrown.

Overloads (3):

Create

Create(Document,ElementId,ElementId,Connector,Connector)

Create(Document,ElementId,ElementId,Connector,XYZ)

Create(Document,ElementId,ElementId,ElementId,XYZ,XYZ)

public static Duct Create(
	Document document,
	ElementId ductTypeId,
	ElementId levelId,
	Connector startConnector,
	Connector endConnector
)

Public Shared Function Create ( 
	document As Document,
	ductTypeId As ElementId,
	levelId As ElementId,
	startConnector As Connector,
	endConnector As Connector
) As Duct

public:
static Duct^ Create(
	Document^ document, 
	ElementId^ ductTypeId, 
	ElementId^ levelId, 
	Connector^ startConnector, 
	Connector^ endConnector
)

static member Create : 
        document : Document * 
        ductTypeId : ElementId * 
        levelId : ElementId * 
        startConnector : Connector * 
        endConnector : Connector -> Duct

Document

document

The document.
ElementId

ductTypeId

The ElementId of the new duct type.
ElementId

levelId

The level ElementId for the new duct.
Connector

startConnector

The first connector where the new duct starts.
Connector

endConnector

The second point of the new duct.

Return Value Duct The created duct.

ArgumentException

The duct type ductTypeId is not valid duct type. -or- The ElementId levelId is not a Level. -or- The connector's domain is not Domain.â€‹DomainHvac. -or- The points of startConnector and endConnector are too close: for MEPCurve, the minimum length is 1/10 inch.
ArgumentNullException

A non-optional argument was null
InvalidOperationException

Thrown when the new duct fails to connect with the connector.