Sets the ExternalFileReference information which Revit should use the next time it opens the document which this TransmissionData belongs to.

Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 2015.0.0.0 (2015.0.0.0)
Since: 2012

Syntax

C#
`public void SetDesiredReferenceData( ElementId elemId, ModelPath path, PathType pathType, bool shouldLoad )`

Visual Basic
`Public Sub SetDesiredReferenceData ( _ elemId As ElementId, _ path As ModelPath, _ pathType As PathType, _ shouldLoad As Boolean _ )`

Visual C++
`public: void SetDesiredReferenceData( ElementId^ elemId, ModelPath^ path, PathType pathType, bool shouldLoad )`

Parameters

elemId: Type: Autodesk.Revit.DB ElementId
The id of the element associated with this reference.

path: Type: Autodesk.Revit.DB ModelPath
A ModelPath indicating the location to load the external file reference from.

pathType: Type: Autodesk.Revit.DB PathType
A PathType value indicating what type of path the ModelPath is.

shouldLoad: Type: System Boolean
True if the external file should be loaded the next time Revit opens the document. False if it should be unloaded.

Remarks

There must already be a reference associated with the given id for this function to be valid. New references cannot be created in a closed file. See the documentation for a particular reference type to see its creation API.

Exceptions

Exception	Condition
Autodesk.Revit.Exceptions ArgumentException	elemId does not correspond to an ExternalFileReference contained in this TransmissionData. -or- These inputs will not produce a valid ExternalFileReference.
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

SetDesiredReferenceData Method

Syntax

Parameters

Remarks

Exceptions

See Also

Put AI to work inside Revit.