Autodesk.Revit.DB.ExternalService.ExternalServices

Autodesk.Revit.DB.ExternalService.ExternalServices 类是 Revit API 中的一个类，用于管理 Revit 外部服务。它提供了获取、注册、卸载外部服务的方法，通过与外部服务进行交互，可以进行进一步的操作和功能增强。

方法

static ExternalService FindService(Guid serviceId)

通过 serviceId 获取已注册的外部服务。

• 参数：
  • serviceId：类型为 Guid，表示外部服务的 ID。
• 返回值：
  • ExternalService：找到的外部服务，如不存在则返回 null。

static ExternalService RegisterService(Guid serviceId, string serviceName, IExternalService service)

注册外部服务。

• 参数：
  • serviceId：类型为 Guid，表示外部服务的 ID。
  • serviceName：类型为 string，表示外部服务的名称。
  • service：实现 IExternalService 接口的外部服务对象。
• 返回值：
  • ExternalService：新注册的外部服务。

static void UnregisterService(Guid serviceId)

取消注册已注册的外部服务。

• 参数：
  • serviceId：类型为 Guid，表示要取消注册的外部服务的 ID。

static void UnregisterService(ExternalService service)

取消注册已注册的外部服务。

• 参数：
  • service：要取消注册的外部服务。

异常

• ArgumentException：在注册服务时，serviceId 已经被占用。
• ArgumentNullException：service 为 null。

示例

获取已注册的外部服务

// 获取外部服务
var service = ExternalServices.FindService(Guid.Parse("2c5932f4-e4d8-4cb4-80e9-9a05d0c8bc1f"));

// 操作外部服务
service.DoSomething();

注册外部服务

// 注册外部服务
var newService = ExternalServices.RegisterService(Guid.Parse("2c5932f4-e4d8-4cb4-80e9-9a05d0c8bc1f"), "MyServiceName", new MyExternalService());

// 使用新注册的外部服务
newService.DoSomething();

取消注册外部服务

// 取消注册外部服务
ExternalServices.UnregisterService(Guid.Parse("2c5932f4-e4d8-4cb4-80e9-9a05d0c8bc1f"));