DicomClient 是 fo-dicom 中负责和 DICOM 服务端建立关联、发送请求并接收响应的核心客户端组件。PACS 查询、验证、检索和存储这几类操作，基本都绕不开它。

1. 它负责什么

DicomClient 主要负责下面几件事：

1. 与 PACS 建立和维护 DICOM 关联。
2. 发送 DICOM 请求，例如 C-ECHO、C-FIND、C-MOVE、C-STORE。
3. 按顺序处理请求队列。
4. 接收服务端响应，并通过回调或异步流程向上层暴露结果。
5. 支持异步调用，避免 UI 或主流程被网络操作阻塞。

2. 常见构建方式

var client = new DicomClient(
    host,
    port,
    useTls,
    callingAeTitle,
    calledAeTitle,
    requestTimeout: 5000,
    releaseTimeout: 10000,
    lingerTimeout: 50,
    maximumNumberOfRequests: null
);

参数含义通常可以这样理解：

1. host：PACS 地址。
2. port：PACS 服务端口。
3. useTls：是否启用 TLS。
4. callingAeTitle：本地 AE Title。
5. calledAeTitle：远端 AE Title。
6. requestTimeout：请求建立超时。
7. releaseTimeout：释放关联超时。
8. lingerTimeout：处理完请求后保持关联一小段时间。
9. maximumNumberOfRequests：单次关联中允许的请求数量上限。

3. 发送请求

最小用法就是：

await client.AddRequestAsync(request);
await client.SendAsync();

同步写法也能用，但在现代应用里更推荐异步方式：

client.AddRequestSync(request);
client.SendSync();

4. 使用上的核心前提

真正能不能连通，通常不只取决于代码本身，还取决于下面几项是否一致：

1. IP 和端口是否正确。
2. Calling AE Title 是否符合对端配置。
3. Called AE Title 是否匹配目标服务。
4. 对端是否允许当前主机访问。
5. TLS、传输语法和请求模型是否匹配。

如果这些概念还不够清楚，建议先回看前面的通讯基础章节：

1. 1.DICOM 通讯基础
2. 2.AE Title 与节点配置
3. 4.Association 与 Presentation Context

5. 阅读顺序建议

1. 先用 6.C-ECHO 验证链路是否打通。
2. 再看 7.C-FIND 做元数据查询。
3. 需要实际取回影像时，再继续看 8.C-MOVE 和 9.C-STORE。

版权所有

版权归属：Ailurus-2233

许可证：署名 4.0 国际 (CC-BY-4.0)

贡献者: WangZhiYu

上一页Association 与 Presentation Context

下一页C-ECHO