简介面向工业自动化与数据采集领域的开发者这是一份基于VS2010和OPC Net Api Chs工具库的C# OPC客户端完整工程示例。资源以OPCTest项目为载体清晰演示了连接OPC服务器、浏览并选择组/项、订阅实时数据、主动读写以及断开连接等关键流程同时涵盖常见错误处理与服务器事件响应。通过阅读和运行该示例开发者能够掌握C#与OPC通信的基本套路并快速迁移至实际上位机开发中。压缩包共包含71个文件以cs源码、dll依赖、exe可执行程序、txt说明为主辅以工程配置、界面资源和图标等整体大小仅2.84MB目录结构简洁便于逐文件分析。其中既有完整源码也有编译后的程序和配套库文件适合初学OPC或需要快速验证客户端功能的工程师对照调试。已有253人学习下载是一份轻量、实用且能直接上手的工业通信参考资源。1. C# OPC客户端测试为什么设备连上了值却读不到做 C# 上位机开发的工程师几乎都会在某一天接到这样一个需求把 PLC、仪表或者产线上设备的数据读上来界面显示或者把控制指令写下去。设备侧通常已经提供了 OPC Server你只需要写一个 OPC 客户端把它当作设备数据的入口。C# OPC客户端测试这件事就是预先验证“我的程序能不能稳定拿到数据”,而不是等到上位机跑起来才发现值不对。很多新人的首次翻车都发生在同一个点服务器地址能 ping 通UA Expert 也能连上但自己用 C# 写出来的客户端要么握手失败要么读出来的浮点数是天文数字要么订阅回调一个也不触发。这些问题的根因往往不在业务代码而在协议选型、证书信任和订阅参数这三件事上。这篇文章按我平时的调试路径展开先定协议再搭环境然后写最小可运行客户端最后把排障经验一条条列给你。2. 先定协议再写代码OPC DA、OPC UA 和本地直连怎么选动手写代码之前第一件事是确认设备侧到底给你开了什么口子。OPC 历史上分成两代一代是基于 Windows COM/DCOM 的 OPC DA一代是基于 TCP/IP 的 OPC UA。两者在 C# 客户端的实现方式完全不同引入的依赖也不同。含 OPC DA 的写法最终要面对 DCOM 权限、防火墙、位数匹配这些黑匣子写 OPC UA 客户端则要处理证书信任和端点选择。搞清楚设备侧支持哪种能省掉后面一半的排障时间。2.1 OPC DA 的 DCOM 依赖老协议的三个硬约束OPC DA 出现得早很多老旧产线、存量 DCS/PLC 系统至今只提供 DA 接口。它的底层是 COM/DCOM走 Windows RPC所以天生有三个硬约束。第一客户端和服务器必须在同一套 Windows 域或可互信的计算机环境下跨网段访问要额外配置 Windows 防火墙与组件服务。第二进程位数必须对上多数老 OPC 服务器是 32 位进程你的 C# 测试程序如果编译成 x64很大概率连不上或读不到数据这时需要把测试工程改成 x86。第三DCOM 默认只允许启动和访问权限内的用户默认配置下跨机器调用经常直接超时。这些约束在开发机上不明显一旦要部署到工控机就全部暴露。C# 侧写 DA 客户端常见做法是引用 OPC Foundation 的 OpcRcw.Com 和 OpcRcw.Da 互操作程序集或者直接用第三方封装库。比起写代码DA 测试花时间最多的地方是环境。我第一次在公司工控机上连一个老款西门子 PCS7 的 OPC Server花了大半天配置组件服务里的 DCOM 权限代码本身反而十分钟写完。所以我的建议是新项目优先确认设备是否支持 UA只有存量系统才死守 DA。2.2 OPC UA 的证书与端点新一代客户端都往这走OPC UA 不再依赖 DCOM默认走 TCP 4840 端口也支持 HTTPS。它在 C# 侧有官方维护的 OPCFoundation.NetStandard.Opc.Ua 库跨平台可用部署到 Linux 工控机也没问题。UA 的连接流程比 DA 多一步客户端与服务器之间要交换证书。默认安全策略下服务器不信任你的客户端证书握手就会失败错误码通常类似 BadSecurityChecksFailed。因此UA 客户端的“测试”二字往往是从证书信任开始的。你可以选择完全关闭安全SecurityMode.None也可以把客户端证书导入服务器信任列表。开发调试阶段我一般直接用 None 或 AutoAcceptUntrustedCertificates上线前再按生产策略做成正式证书。另一个 UA 特性是“端点Endpoint”概念一个 UA 服务器可能暴露多个端点每个端点对应不同的安全策略和地址客户端需要先查询端点列表再选择一个匹配安全策略的端点去创建会话。这一步如果没做你写的固定连接地址可能恰好命中了一个要求高安全级别的端点然后就卡在证书上。2.3 DA 与 UA 选型对比一张表说清边界选型不是越新越好要看设备侧和部署环境。下面这张表是我做选型时常用的对比维度OPC DAOPC UA厂商 SDK 直连底层机制COM/DCOMTCP 4840 / HTTPS私有协议平台仅 WindowsWindows/Linux随厂商传输安全弱依赖 DCOM 权限证书 加密厂商实现位数要求客户端/服务器位数必须一致无强制一致性无强制部署复杂度高中低适用场景存量老系统、老 DCS新项目、跨网段采集单设备、高性能采集厂商 SDK 直连在“上位机只连一家设备”时是性能最好的方案例如西门子 S7 就用 S7-200/300/400 的 Native 驱动毫秒级循环读不成问题。但它绑死了厂商换设备就要换驱动。引入 OPC 层虽然多一跳换来的是点位模型统一测试脚本可以复用换服务器只改地址。我在做点位数百以上的项目时一律优先 UA只有设备侧只有 DA 时才回到 DA 加 DCOM 的老路。3. 搭一套免费的测试环境模拟服务器、UA Expert 与验证清单写客户端之前得先有一个能连的 OPC 服务器。很多项目里设备还没到场或者产线正在运行不可能拿真实 PLC 做联调。所以一套免费可用的模拟服务器和客户端探针工具是 C# OPC客户端测试的地基。注意模拟服务器不能代替真实设备验证协议能力但至少能把代码流程跑通。3.1 用 UA Expert 当探针先证明服务器能连UA Expert 是 OPC Foundation 官方发布的免费测试客户端Windows 下解压即用。它的价值不是“浏览节点”而是帮你区分问题归属如果 UA Expert 连不上某台服务器那大概率是服务器端或网络环境的问题不是你 C# 代码的问题。我先用 UA Expert 连一次能连上并看到节点树再回头写 C# 客户端。UA Expert 里值得看两个信息一是端点列表的安全策略二是节点树里每个变量的 NodeId。我们写 C# 代码时要用到 NodeId例如一个正弦波变量可能是ns3;i1006这种格式ns 是命名空间索引i 是数字节点 ID这些信息在 UA Expert 的节点属性面板里直接可见。我之前遇到过有人对着文档里给的 NodeId 写代码却读不到值原因是文档是旧版本变量实际已经换了命名空间索引。以 UA Expert 实际查到的为准别信文档。3.2 免费的OPC服务器Prosys 模拟器与 DA 端的选择OPC UA 侧我常用的免费模拟服务器是 Prosys OPC UA Simulation Server。它带一组可写的模拟变量包括计数器、随机数、正弦波、布尔开关等安装后默认监听 4840 端口同一局域网里的其他机器也能访问。对于客户端测试来说这组变量足够验证浏览、读写、订阅三条核心路径。它免费版有使用时长和点位数的限制但做开发和功能验证完全够用。OPC DA 侧的老牌选择是 Matrikon OPC Simulation免费模拟出几十个 DEMO 点位逻辑值、模拟量都有。如果你是做 DA 客户端测试装它最省事。更早的还有 WinCC 自带的 OPC Server但那要配合完整环境不推荐专门为测试去装。无论哪种模拟服务器验证标准都一样先用官方探针工具连上再把自己写的 C# 客户端连上去做同样的操作。3.3 动手前的环境检查清单我每次在陌生机器上做 OPC 联调都会先过一遍下面的检查清单能省很多无用功检查项核实内容典型错误服务器地址与端口opc.tcp://IP:4840确认防火墙放行只改了 IP 忘了端口安全策略None / Basic256Sha256 选哪一种客户端默认带签名服务器配置不匹配证书状态客户端证书是否被服务器接受自动接受开关没打开位数DA 场景确认工程是 x86/x64AnyCPU 在 64 位系统下走了 x64 路径用户名密码匿名还是需要 UserIdentity带域账户名导致验证失败这份清单本质上定位的是“连接之前的环境问题”。它解决不了后面写再多代码都白搭。4. 用 C# 写最小 OPC UA 客户端连接、浏览、读写、订阅这一章给出一套可运行的最小 UA 客户端代码。我用的是 OPCFoundation.NetStandard.Opc.Ua 库NuGet 包名是 OPCFoundation.NetStandard.Opc.Ua版本差异不大API 基本稳定。下面的代码段按“初始化 → 连接 → 浏览 → 读写 → 订阅”顺序组织你可以直接放进一个控制台工程跑。4.1 NuGet 引库与证书自动信任的初始化UA 客户端的第一步是创建 ApplicationConfiguration。它负责把客户端程序的身份告诉服务器包括应用名、应用 URI以及证书信任行为。开发阶段我习惯开启自动接受不受信任的证书省去手动导入。using Opc.Ua; // 构造客户端应用配置 var config new ApplicationConfiguration { ApplicationName MyOpcTestClient, ApplicationUri urn:MyOpcTestClient, ApplicationType ApplicationType.Client, SecurityConfiguration new SecurityConfiguration { // 开发阶段自动接受服务器下发的证书 AutoAcceptUntrustedCertificates true, // 证书和受信任列表留空由库自动生成临时证书 }, TransportQuotas new TransportQuotas { OperationTimeout 60000 } }; // 校验配置是否合法并生成本地证书 await config.Validate(ApplicationType.Client);这里AutoAcceptUntrustedCertificates true是开发阶段的关键开关。正式环境要把它关掉改由服务器手动信任客户端证书。Validate会检查配置完整性并在本地生成客户端的应用证书如果该步报错先看是不是当前用户目录没有写权限。4.2 连接服务器并建立会话连接分两步先通过地址找到可用端点再基于端点创建会话。注意不要硬编码EndpointDescription因为你固定的地址可能指向多个端点安全策略不匹配时会握手失败。var endpointUrl opc.tcp://localhost:4840; // 从服务器获取端点列表并选择无安全策略的端点 var selectedEndpoint CoreClientUtils.SelectEndpoint(config, endpointUrl, useSecurity: false); // 基于端点和传输配置创建会话 var endpoint new ConfiguredEndpoint(null, selectedEndpoint, EndpointConfiguration.Create(config)); var session await Session.Create( config, endpoint, false, // 连接前不更新端点信息 MySession, // 会话名 60000, // 会话超时时间毫秒 new UserIdentity(), // 匿名身份 null); // 可传入自定义传输通道CoreClientUtils.SelectEndpoint的参数useSecurity: false表示优先选择无安全策略的端点开发期很方便。如果你要测试加密链路这里改成true并把下方配置里的证书路径补齐。如果连接报BadSecurityChecksFailed几乎可以确定是证书信任问题。回头确认 4.1 里的自动接受开关是否真的生效或者查看服务器端的拒绝证书列表。4.3 浏览节点树找到要读的变量连接之后先在代码里实现一次节点浏览把服务器根节点下的对象树打出来。这一步的价值是拿到真实的 NodeId而不是靠猜。var requestHeader new RequestHeader { Timestamp DateTime.UtcNow, TimeoutHint 60000 }; var browseDescription new BrowseDescription { NodeId NodeId.Parse(ObjectIds.ObjectsFolder.ToString()), BrowseDirection BrowseDirection.Forward, ReferenceTypeId ReferenceTypeIds.HierarchicalReferences, IncludeSubtypes true, NodeClassMask (uint)NodeClass.Object | (uint)NodeClass.Variable, ResultMask (uint)BrowseResultMask.All }; var browseResponse await session.BrowseAsync( requestHeader, null, 0, new BrowseDescriptionCollection { browseDescription }); foreach (var reference in browseResponse.Results[0].References) { Console.WriteLine(${reference.DisplayName} - {reference.NodeId}); }浏览结果是ReferenceDescription里面包含子节点的名字和 NodeId。拿到之后挑一个变量节点DisplayName 通常是 Counter、Random、Sinusoid 之类记下它的 NodeId下一步读写就用它。Prosys 模拟服务器里的变量大多放在 “Simulation” 对象下浏览一次就能看到。4.4 读变量、写变量一次读写的完整代码读写变量是最核心的操作。下面给出了读取一个 float 变量并写回另一个变量的完整代码。注意 UA 的值携带了类型信息读出来的Value是 object需要按实际类型转换。// 读变量NodeId 换成浏览到的那一个 var readNodeId new NodeId(ns3;i1006); var readValue new ReadValueId { NodeId readNodeId, AttributeId Attributes.Value }; var readResponse await session.ReadAsync( new RequestHeader(), 0, // maxAge允许返回旧值0 表示尽量读新值 TimestampsToReturn.Both, // 同时返回来源时间戳和服务端时间戳 new ReadValueIdCollection { readValue }); // 判断状态码再按类型强转 var dataValue readResponse.Results[0].Value; Console.WriteLine($Value {dataValue.Value}, Status {dataValue.StatusCode}); // 写变量把 80.5 写入另一个可写节点 var writeNodeId new NodeId(ns3;i1002); var writeValue new WriteValue { NodeId writeNodeId, AttributeId Attributes.Value, Value new DataValue(new Variant(80.5f)) }; var writeResponse await session.WriteAsync( new RequestHeader(), new WriteValueCollection { writeValue }); // StatusCode.Code 为 0 表示写入成功 if (writeResponse.Results[0].Code 0) { Console.WriteLine(Write OK); } else { Console.WriteLine($Write failed: {writeResponse.Results[0]}); }关于maxAge参数取值 0 表示必须返回新的数据如果服务器上该变量没有更新会返回BadNoData或旧值允许缓存时把它设成几百毫秒可以减少服务器压力。读写失败时优先确认节点是否允许写入模拟服务器里的很多变量是只读的写只读节点会返回BadNotWritable这不是代码问题是服务器端权限限制。4.5 订阅数据变化把采样间隔、发布间隔当参数调轮询读写能验证功能但生产环境里我们通常用订阅让服务器主动推送变化。订阅有三个关键参数SamplingInterval是服务器采集数据的间隔PublishingInterval是服务器把采集到的数据打包发给客户端的间隔QueueSize是缓冲队列长度。新手最容易在这里犯迷糊。// 创建订阅并设置发布间隔 var subscription new Subscription(session.DefaultSubscription) { PublishingInterval 500, // 每 500ms 向客户端推送一次数据 PublishingEnabled true, KeepAliveCount 10 // 连续 10 个周期无数据时发 KeepAlive }; session.AddSubscription(subscription); subscription.Create(); // 订阅一个变量 var monitoredItem new MonitoredItem(subscription.DefaultItem) { StartNodeId new NodeId(ns3;i1006), AttributeId Attributes.Value, SamplingInterval 100, // 服务器每 100ms 采样一次 QueueSize 10, MonitoringMode MonitoringMode.Reporting }; // 注册通知回调 monitoredItem.Notification (item, args) { var value item.LastValue; Console.WriteLine($Received: {value.Value}); }; subscription.AddItem(monitoredItem); subscription.ApplyChanges();MonitorItem.Notification事件每次数据变化都会触发。注意这里有两个尺度如果PublishingInterval是 500msSamplingInterval是 100ms那么服务器每 100ms 采样得到的数据会合并在 500ms 的发布包里推过来相当于 5 条数据合并发送。如果你想高频拿到每个采样值就要把PublishingInterval调小到采样间隔同一量级。这也是很多工程师问“C# 读取 PLC 频率能到多少”的答案不是你的循环能跑多快而是订阅参数决定的推送频率能到多少。5. 客户端测试避坑5 条常见问题与排查记录OPC 客户端测试里代码写错的比例其实不高坑大多集中在环境、证书和订阅这三类。下面这五条是我在实际项目里真实遇到过的按“现象 → 原因 → 解决”记录方便你照着排查。5.1 现象DA 连接超时报 DCOM 拒绝访问现象C# DA 客户端调用Connect时长时间无响应最终超时事件日志里出现 DCOM 错误 10016。原因对方机器的 DCOM 权限不允许当前用户启动服务器。默认情况下DCOM 只允许本地管理员启动跨机器访问没有额外授权。解决在服务器端运行dcomcnfg进入“组件服务 → 计算机 → 我的电脑 → DCOM 配置”找到对应的 OPC 服务器名称像Opc.SimNet.1打开属性对话框在“安全”标签里把“启动和激活权限”“访问权限”都改为允许 Everyone 或指定用户。同时确保 Windows 防火墙放行 TCP 135 端口和动态 RPC 端口通常是 49152-65535 段。这步做完不用改代码重连即可验证。5.2 现象UA 握手失败证书不受信任现象C# 客户端执行Session.Create时抛异常错误码BadSecurityChecksFailed。原因客户端证书没有出现在服务器的受信任证书列表服务器拒绝会话建立。即使用了AutoAcceptUntrustedCertificates true有些服务器只接受自己信任名单里的证书。解决先在配置里确认AutoAcceptUntrustedCertificates true是否真的生效如果还不行启动服务器的管理界面或 UA Expert找到“拒绝的证书”列表把客户端的证书加入信任列表。客户端证书通常生成在%LOCALAPPDATA%\OPC Foundation\CertificateStores下指纹和主题信息会打印在异常消息里。用 UA Expert 连接时它也会提示是否信任该证书点“Trust”即可。5.3 现象能读能写订阅就是不触发现象UA 客户端浏览、读写都正常但订阅事件永远不触发。原因最常见的是SamplingInterval和PublishingInterval设置过大或为 0。SamplingInterval 0表示服务器按最小周期采样有些实现会把 0 当成“不采样”另一个原因是MonitoringMode没有设置为Reporting。解决明确设置SamplingInterval 100、PublishingInterval 500并把MonitoringMode设为Reporting。还有个容易被忽略的点订阅要调用subscription.Create()监控项要调用subscription.ApplyChanges()这两个调用缺一不可。我曾见到过代码把Create写在AddItem之前导致监控项没有生效。5.4 现象读写整数正常读 float 全错现象UA 客户端读 int、bool 都对但读 float 得到的是天文数字比如 3.4E38 或 0。原因类型强转不正确。OPC UA 的值类型是Variant底层可能是 float、double 或 decimal如果你直接用(float)(object)强转遇到底层是 double 时就会溢出输出无意义的极大值。解决先用Type.GetTypeCode()判断基础类型再按类型转换。我一般写成var raw dataValue.Value; if (raw is float f32) Console.WriteLine($float: {f32}); else if (raw is double f64) Console.WriteLine($double: {f64}); else Console.WriteLine($type: {raw.GetType()});这个“玄学”问题本质是 UA 的类型系统比 COM 更严格没有隐式转换。5.5 现象服务器重启后客户端再也连不上现象测试过程中重启了模拟服务器或者真实设备断电恢复客户端后续所有读写都报超时。原因会话的底层传输通道已经断开但Session对象还保留着旧的连接状态。你没有监听重连事件也没有做会话重建。解决订阅SessionReconnectHandler在会话丢失后主动重建session.ReconnectHandler (s, e) { if (e.State SessionReconnectState.Closed) { // 关闭旧会话重新走 4.2 的流程创建新会话 session.Dispose(); // 此处重新执行 SelectEndpoint Session.Create } };没有自动重连的客户端在无人值守的上位机上迟早翻车。生产环境的代码里我会在重连失败后加入退避重试间隔从 1 秒逐步拉长到 30 秒避免服务器刚恢复就被连接风暴打挂。6. 别停在单个点批量点表测试与断线重连单个节点的读写跑通只能说明链路是通的距离“客户端测试”完成还差一步把整份点表跑一遍。常见做法是准备一个 CSV 点表文件每行包含 NodeId、数据类型、读写方向、预期范围然后写一段脚本循环执行读写并记录结果。var lines File.ReadAllLines(points.csv); foreach (var line in lines.Skip(1)) // 跳过表头 { var cols line.Split(,); var nodeId new NodeId(cols[0]); var expectedType cols[1]; var response await session.ReadAsync(new RequestHeader(), 0, TimestampsToReturn.Both, new ReadValueIdCollection { new ReadValueId { NodeId nodeId, AttributeId Attributes.Value } }); var value response.Results[0].Value.Value; var status response.Results[0].Value.StatusCode.Code; Console.WriteLine(${nodeId}\t{status}\t{value}); // 统计 status 非 0 的节点作为失败清单 }把这套脚本跑完后直接看失败清单而不是一个个手动点。我做过一个 400 点的项目靠人工验证花了半天改成点表脚本后十分钟跑完还顺带发现三个节点在服务器端就没有值。断线重连也不要在最后才测联调一开始就把重启模拟服务器当作一个测试用例写进计划。我第一次做 OPC 客户端测试就吃过 DCOM 的亏新环境连服务器本身都费了大半天后来养成的习惯是任何新环境都先用 UA Expert 验证服务器端再用 C# 代码连。先把探针工具跑通再写自己的客户端这条习惯帮我省下的时间足够写好几个测试脚本了。希望帮到你。本文还有配套的精品资源点击获取