NodeCollection — ua.Nodes

NodeCollection 是 Session 的节点访问入口, 通过索引器返回 OpcUaNode 包装对象, 不立即触发 RPC (Lazy Load).

前置阅读

• 单节点 API 请看 OpcUaNode.
• 标准节点常量请看 WellKnownNodes.

索引器

索引	返回	说明
Nodes[string nodeId]	OpcUaNode	字符串 NodeId 访问

预定义入口属性

为方便, 内置常用入口:

类别	属性	类型	访问	说明
标准入口	Root	OpcUaNode	R	Address Space 根 (i=84)
	Objects	OpcUaNode	R	业务数据根 (i=85)
	Types	OpcUaNode	R	类型定义根 (i=86)
	Server	OpcUaNode	R	Server 自身对象 (i=2253)

// 这两行等价
using var t1 = ua.Nodes.Server["ServerStatus"]["CurrentTime"].Value;
using var t2 = ua.Nodes["i=2253"]["ServerStatus"]["CurrentTime"].Value;

---

Lazy Load 机制

var node = ua.Nodes["ns=2;s=Temperature"];  // ← 不触发 RPC
using var dv = node.Value;                  // ← 第一次 .Value 才触发 Read

第二次访问 .Value 还是会重新 Read (无缓存), 因为变量值随时变. 想缓存自己存变量.

---

子节点 BrowseName 索引

var sub = node["ChildName"];  // 通过 BrowseName 浏览子节点

底层逻辑:

1. 立即用 Browse(currentNodeId) 拿到子节点列表
2. 找到 BrowseName == "ChildName" 的子, 返回 OpcUaNode 包装
3. 找不到抛 KeyNotFoundException

第一次访问会有 RPC 开销 (~5-10 ms), 后续路径访问连串都是单次 Browse 的结果.

---

何时用索引器, 何时用字符串

场景	推荐
已知精确 NodeId	字符串 (ua.Read("ns=2;s=..."))
标准节点 (Server 状态等)	Nodes.Server[...]
浏览树 / 写一次性脚本	索引器 (Nodes["..."]["..."])
批量 (100+ 节点)	ReadMany / BrowseMany, 不要循环

下一步

• OpcUaNode
• Browse