Namespaces — ua.Namespaces

OPC UA 节点 NodeId 由 NamespaceIndex + Identifier 组成, 但 NamespaceIndex 不稳定 — Server 重启可能改变. 生产代码必须用 NamespaceUri 反查 Index, 不能硬编码 ns=2.

前置阅读

• 标准 ns=0 节点常量请参考 WellKnownNodes.
• 节点 Browse / 路径解析请参考 Nodes.

NamespaceCollection 公共成员

DarraOpcUa.Namespaces 是 NamespaceCollection, 在 Connect 时自动从服务端 NamespaceArray (i=2255) 加载.

类别	属性	类型	访问	说明
属性	Count	int	R	命名空间数量
	this[int i]	string	R	索引访问, 返回该 Index 对应的 URI
	Uris	IReadOnlyList<string>	R	全部 URI 列表

方法

方法	返回	说明
GetIndex(uri)	int / -1	反查 URI → Index, 找不到返回 -1
Reload()	void	主动重读服务端 NamespaceArray (Server 动态变更时)

---

常见用法

反查 Index 拼 NodeId

ua.Connect();
int idx = ua.Namespaces.GetIndex("urn:my-company:plc1");
if (idx < 0) throw new InvalidOperationException("Server does not have my namespace");

string nodeId = $"ns={idx};s=Temperature";
using var dv = ua.Read(nodeId);

列出全部命名空间 (调试)

foreach (var (uri, i) in ua.Namespaces.Uris.Select((u, i) => (u, i)))
    Console.WriteLine($"  [{i}] {uri}");

输出示例:

[0] http://opcfoundation.org/UA/
[1] urn:server-host
[2] urn:my-company:plc1
[3] http://my-company.com/UA/

动态命名空间变更

某些 Server 启动后才注册命名空间 (插件式), Connect 拿到的 NamespaceArray 不全. 此时调 Reload() 重读:

ua.Namespaces.Reload();
int idx = ua.Namespaces.GetIndex("urn:plugin:loaded-after-startup");

---

标准命名空间 (ns=0)

OPC Foundation 规定 Index 0 永远是 http://opcfoundation.org/UA/, 所有标准节点都在 ns=0:

节点	NodeId	说明
Root	i=84	根
Objects	i=85	业务数据根
Types	i=86	类型定义根
Server	i=2253	Server 自身对象
ServerStatus	i=2256	Server 状态结构
ServerStatus.CurrentTime	i=2258	服务端当前时间
NamespaceArray	i=2255	命名空间数组
ServerArray	i=2254	服务端数组

详见 WellKnownNodes.

下一步

• WellKnownNodes 标准节点常量
• Nodes 节点访问