Autodesk.Revit.DB.RevitLinkOptions

Autodesk.Revit.DB.RevitLinkOptions是Revit API中的一个类，对Revit项目中的链接文件进行设置和访问。

构造函数

• RevitLinkOptions(bool defaultPathType)：利用默认路径类型创建RevitLinkOptions对象。 参数：
  • defaultPathType：bool型，用来指定是否使用默认路径类型，True表示使用默认路径类型，False表示不使用，默认为True。

属性

下面列出Autodesk.Revit.DB.RevitLinkOptions常用的属性：

• ReloadLinkedFile：bool型，表示每次打开Revit项目是否重新加载链接文件。True表示重新加载，False表示不重新加载。默认为True。
• DefaultPathType：RevitLinkType型，表示是使用链接文件的绝对路径还是相对路径。默认为RevitLinkType.Absolute。
• Audit：bool型，表示是否修改且维护链接文件。当链接文件出现问题时，如无法访问文件或文件已移动，修改此属性后可自动修复链接。默认为False。
• DetachFromCentralOption：DetachFromCentralOption型，表示链接文件是否从中央模型中分离，即是否保留链接文件的BIM360 Worksharing设置。默认为DetachFromCentralOption.DoNotDetach。
• DetailLevel：ViewDetailLevel型，表示链接文件的视图显示水平。默认为ViewDetailLevel.Undefined。

方法

下面列出Autodesk.Revit.DB.RevitLinkOptions常用的方法：

• GetDefaultFilePath(string path)：根据链接相对或绝对路径和DefaultPathType属性获取链接文件的默认路径。 参数：

  • path：string型，链接文件的相对或绝对路径。 返回：
  • string型，链接文件默认路径。

• SetDefaultFilePath(string path)：设置链接文件的默认路径。 参数：

  • path：string型，链接文件的路径。

示例代码

下面是一个示例代码，用于创建链接文件及链接选项对象，并将链接文件加载到Revit模型中：

//创建链接文件
RevitLinkType linkType = RevitLinkType.Imports;
RevitLinkInstance linkInstance = RevitLinkInstance.Create(doc, "C:\\LinkFile.rvt", linkType);
//创建链接选项对象
RevitLinkOptions linkOptions = new RevitLinkOptions(true);
linkOptions.Audit = true;
linkOptions.DetailLevel = ViewDetailLevel.Fine;
//加载链接文件进入Revit模型
doc.LoadFamily(linkInstance, linkOptions);

注：例如链接文件所在的路径为“C:\LinkFile.rvt”，则默认路径为“$(ProjectLocation)\LinkFile.rvt”。如果使用默认路径时，DefaultPathType属性为RevitLinkType.Relative；如果使用自定义路径，则需要通过SetDefaultFilePath()方法手动设置文件路径。