insertAt MethodStatic


insertAt(txn, elProps, linearElementId, atPosition)

Insert a new LinearlyLocated element into an iModel at a specific location along an existing Linear-Element.

insertAt(txn: EditTxn, elProps: ElementProps, linearElementId: string, atPosition: LinearlyReferencedAtLocationProps): string

@returns The newly inserted element's Id.

@throws IModelError if unable to insert the element.

Parameter Type Description
txn EditTxn The EditTxn used to perform inserts.
elProps ElementProps The properties of the new element.
linearElementId string The Id of the Linear-Element along which the new LinearlyLocated will be inserted.
atPosition LinearlyReferencedAtLocationProps Linear position.

Returns - string

The newly inserted element's Id.



insertAt(iModel, elProps, linearElementId, atPosition)

Deprecated  Use LinearlyLocated.insertAt(txn, ...) instead, within an explicit EditTxn scope (or via withEditTxn). See EditTxn documentation for migration help.

Insert a new LinearlyLocated element into an iModel at a specific location along an existing Linear-Element.

insertAt(iModel: IModelDb, elProps: ElementProps, linearElementId: string, atPosition: LinearlyReferencedAtLocationProps): string

@returns The newly inserted element's Id.

@throws IModelError if unable to insert the element.

Parameter Type Description
iModel IModelDb The iModel to insert the new element into.
elProps ElementProps The properties of the new element.
linearElementId string The Id of the Linear-Element along which the new LinearlyLocated will be inserted.
atPosition LinearlyReferencedAtLocationProps Linear position.

Returns - string

The newly inserted element's Id.


Defined in

Last Updated: 25 April, 2026