M

ImportInstance.Create

Description:
Creates a new instance of DWG or DXF link type from a file path and loads the linked file.

Remarks:

This function creates a new DWG or DXF link type as well as a new instance of this link type. The new instance of DWG or DXF link type is returned by this function and the element id of the new DWG or DXF link type is contained in the LinkLoadResult.

If the given full path of the DWG or DXF file to link is already used by an existing DWG or DXF link type, a new instance of this existing DWG or DXF link type will be created and returned. The element id of the existing DWG or DXF link type is contained in the LinkLoadResult.

This function regenerates the input document.

Overloads (9):

Create(Document,ElementId,View)

Create(Document,View,ExternalResourceReference,DGNImportOptions,LinkLoadResult)

Create(Document,View,ExternalResourceReference,DWGImportOptions,LinkLoadResult)

Create(Document,View,ExternalResourceReference,ImportOptions3DM,LinkLoadResult)

Create(Document,View,ExternalResourceReference,OBJImportOptions,LinkLoadResult)

Create(Document,View,ExternalResourceReference,SATImportOptions,LinkLoadResult)

Create(Document,View,ExternalResourceReference,SKPImportOptions,LinkLoadResult)

Create(Document,View,ExternalResourceReference,STLImportOptions,LinkLoadResult)

Create(Document,View,String,DWGImportOptions,LinkLoadResult)

public static ImportInstance Create(
	Document document,
	View DBView,
	string path,
	DWGImportOptions options,
	out LinkLoadResult linkLoadResult
)

Public Shared Function Create ( _
	document As Document, _
	DBView As View, _
	path As String, _
	options As DWGImportOptions, _
	<OutAttribute> ByRef linkLoadResult As LinkLoadResult _
) As ImportInstance

public:
static ImportInstance^ Create(
	Document^ document, 
	View^ DBView, 
	String^ path, 
	DWGImportOptions^ options, 
	[OutAttribute] LinkLoadResult^% linkLoadResult
)

Autodesk.Revit.DB.Document

document

The document in which to create the DWG or DXF link.
Autodesk.Revit.DB.View

DBView

The view into which the DWG or DXF link will be created.
String

path

The full path of the DWG or DXF file to link. The path must exist and must be a valid DWG or DXF file.
Autodesk.Revit.DB.DWGImportOptions

options

Various import options applicable to the DWG format. If nulla null reference (Nothing in Visual Basic), all options will be set to their respective default values.
Autodesk.Revit.DB.LinkLoadResult%

linkLoadResult

An object containing the results of creating and loading the DWG or DXF link. It contains the ElementId of the new created DWG or DXF link type.

Return Value ImportInstance The new instance of DWG or DXF link type.

Autodesk.Revit.Exceptions.ArgumentException

document is not a project document. -or- document is in an edit mode. -or- Import is temporarily disabled. -or- The view is not printable. -or- NullOrEmpty -or- Not a valid file for DWG import (.dwg and .dxf files are valid). -or- ThisViewOnly cannot be true when importing a DWG|DGN drawing into a 3D view. -or- One or more strings describing layer selection is invalid or empty. -or- The line weights are not valid; either it contains an invalid number of line weights, or a line weight outside the valid range. -or- The scale is not valid as a CustomScale for use during import.
Autodesk.Revit.Exceptions.ArgumentNullException

A non-optional argument was null
Autodesk.Revit.Exceptions.FileArgumentNotFoundException

The given path does not exist.
Autodesk.Revit.Exceptions.InvalidOperationException

Place by shared, and the host model and the link do not share the same coordinate system. Or place by shared, and the shared coordinates of the host model do not match the GIS coordinate system of the link.
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 DWG Import/Link module is not available in the installed Revit.