Import Method (String, ImportOptions3DM, View)


Imports a 3DM file into the document.

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

Syntax

C#
public ElementId Import(
	string file,
	ImportOptions3DM options,
	View pDBView
)
Visual Basic
Public Function Import ( _
	file As String, _
	options As ImportOptions3DM, _
	pDBView As View _
) As ElementId
Visual C++
public:
ElementId^ Import(
	String^ file, 
	ImportOptions3DM^ options, 
	View^ pDBView
)

Parameters

file
Type: System String
Full path of the file to import. File must exist and must be a valid 3DM file.
options
Type: Autodesk.Revit.DB ImportOptions3DM
Various import options applicable to the 3DM format. If a null reference ( Nothing in Visual Basic) , all options will be set to their respective default values.
pDBView
Type: Autodesk.Revit.DB View
View used to aid placement of the imported file. If the options specify ThisViewOnly, this argument is required and the imported file will only be visible in the specified view. If the options specify center-to-center placement, this argument is required and the imported file will be placed in the center of the specified view. Otherwise, this view is used to obtain a base level to associate with the imported file. If not specified, an existing view will be chosen instead and may open a view or associate the imported file to an arbitrary level.

Return Value

Returns the element Id of the imported instance.

Exceptions

Exception Condition
Autodesk.Revit.Exceptions ArgumentException Not a valid file for 3DM import (.3dm files are valid). -or- ThisViewOnly cannot be true when importing a DWG|DGN drawing into a 3D view. -or- The provided view is not valid for the options provided. -or- One or more strings describing layer selection is invalid or empty. -or- The scale is not valid as a CustomScale for use during import. -or- NullOrEmpty -or- The view is not printable.
Autodesk.Revit.Exceptions ArgumentNullException A non-optional argument was null
Autodesk.Revit.Exceptions FileArgumentNotFoundException The given file does not exist.
Autodesk.Revit.Exceptions InvalidOperationException Import is temporarily disabled.
Autodesk.Revit.Exceptions ModificationForbiddenException The document is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements). -or- The document is being loaded, or is in the midst of another sensitive process.
Autodesk.Revit.Exceptions ModificationOutsideTransactionException The document has no open transaction.
Autodesk.Revit.Exceptions OptionalFunctionalityNotAvailableException The 3DM Import/Link module is not available in the installed Revit.

See Also