Document.LoadFamily(String, IFamilyLoadOptions, Family.)

Public Class

Loads an entire family and all its types/symbols into the document and provides a reference to the loaded family.

Assembly: RevitAPI (in RevitAPI.dll) Version: 25.0.0.0 (25.0.0.0)

Syntax

public bool LoadFamily(
  string filename,
  IFamilyLoadOptions familyLoadOptions,
  out Family family
)

Parameters

filenameString

The fully qualified filename of the Family file, usually ending in .rfa.

familyLoadOptions IFamilyLoadOptions

The interface implementation to use when loading a family into the document.

family Family.

A reference to the family that was loaded if successful, otherwise Nothing.

Return Value

Boolean
True if the entire family was loaded successfully into the project, otherwise False.

Exceptions

Exception

Condition

ArgumentException

Thrown when filename is . or empty.

ArgumentNullException

Thrown when the input argument “familyLoadOptions” is ..

Remarks

Loading an entire family may take a considerable amount of time and memory. It is recommended that you use one of the LoadFamilySymbol() methods and only load those symbols that you need.