Full 1.05.06 compliant OPC UA Part 14 (PubSub)

.github/copilot-instructions.md

@@ -101,7 +101,7 @@ This is the official OPC UA .NET Standard Stack from the OPC Foundation. It prov
 - Follow standard C# naming conventions. Do not use underscores in method names.
 - Assembly prefix: `Opc.Ua` (Except applications, or if otherwise requested)
 - Package prefix: `OPCFoundation.NetStandard`
-- Always use a line break after <summary> and before </summary> for all members (except for documentation of fields).
+- Always use a line break after `<summary>` and before `</summary>` for all members (except for documentation of fields). This applies to **every** XML-doc summary, including in sample/application code — never write a single-line `/// <summary> ... </summary>`; always put the text on its own line between the opening and closing tags.
 
 ### Security Requirements
 - **Never hardcode credentials, certificates, or secrets** in source code

.github/workflows/buildandtest.yml

@@ -34,7 +34,7 @@ jobs:
     outputs:
       csprojs: ${{ steps.list.outputs.csprojs }}
     steps:
-    - uses: actions/checkout@v6
+    - uses: actions/checkout@v7
     - name: Enumerate Tests/Opc.Ua.*.Tests projects
       id: list
       shell: pwsh
@@ -79,7 +79,7 @@ jobs:
       TESTRESULTS: "TestResults-${{matrix.csproj}}-${{matrix.os}}-${{matrix.framework}}-${{matrix.configuration}}"
 
     steps:
-    - uses: actions/checkout@v6
+    - uses: actions/checkout@v7
       with:
         fetch-depth: 0
 
@@ -159,7 +159,7 @@ jobs:
       AOTPROJECT: './Tests/Opc.Ua.Aot.Tests/Opc.Ua.Aot.Tests.csproj'
 
     steps:
-    - uses: actions/checkout@v6
+    - uses: actions/checkout@v7
       with:
         fetch-depth: 0
 

.github/workflows/codeql-analysis.yml

@@ -38,7 +38,7 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v6
+      uses: actions/checkout@v7
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL

.github/workflows/docker-image.yml

@@ -34,7 +34,7 @@ jobs:
       id-token: write
 
     steps:
-    - uses: actions/checkout@v6
+    - uses: actions/checkout@v7
       with:
         fetch-depth: 0
 

.github/workflows/stability-test.yml

@@ -29,7 +29,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v6
+      uses: actions/checkout@v7
       with:
         fetch-depth: 0
 

.github/workflows/stress-test.yml

@@ -36,7 +36,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v6
+      uses: actions/checkout@v7
       with:
         fetch-depth: 0
 

Applications/ConsoleReferencePubSubClient/ConsoleLoggingSink.cs

@@ -0,0 +1,85 @@
+/* ========================================================================
+ * Copyright (c) 2005-2026 The OPC Foundation, Inc. All rights reserved.
+ *
+ * OPC Foundation MIT License 1.00
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ *
+ * The complete license agreement can be found here:
+ * http://opcfoundation.org/License/MIT/1.00/
+ * ======================================================================*/
+
+using System;
+using System.Collections.Generic;
+using System.Text;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Extensions.Logging;
+using Opc.Ua.PubSub.DataSets;
+using Opc.Ua.PubSub.Encoding;
+
+namespace Quickstarts.ConsoleReferencePubSubClient
+{
+    /// <summary>
+    /// <see cref="ISubscribedDataSetSink"/> that prints every received
+    /// DataSetMessage to the console via an
+    /// <see cref="ILogger"/>. Demonstrates the Part 14 §6.2.9 sink
+    /// extension point.
+    /// </summary>
+    public sealed class ConsoleLoggingSink : ISubscribedDataSetSink
+    {
+        private readonly ILogger m_logger;
+        private long m_received;
+
+        public ConsoleLoggingSink(ILogger logger)
+        {
+            if (logger is null)
+            {
+                throw new ArgumentNullException(nameof(logger));
+            }
+            m_logger = logger;
+        }
+
+        public ValueTask WriteAsync(
+            IReadOnlyList<DataSetField> fields,
+            CancellationToken cancellationToken = default)
+        {
+            cancellationToken.ThrowIfCancellationRequested();
+            long sequence = Interlocked.Increment(ref m_received);
+            var builder = new StringBuilder();
+            for (int i = 0; i < fields.Count; i++)
+            {
+                DataSetField field = fields[i];
+                if (i > 0)
+                {
+                    builder.Append(", ");
+                }
+                builder.Append(string.IsNullOrEmpty(field.Name) ? $"f{i}" : field.Name);
+                builder.Append('=');
+                builder.Append(field.Value.IsNull ? "(null)" : field.Value.ToString());
+            }
+            m_logger.LogInformation(
+                "DataSet #{Sequence} received ({FieldCount} fields): {Fields}",
+                sequence, fields.Count, builder.ToString());
+            return ValueTask.CompletedTask;
+        }
+    }
+}

Applications/ConsoleReferencePubSubClient/ConsoleReferencePubSubClient.csproj

@@ -0,0 +1,37 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <OutputType>Exe</OutputType>
+    <AssemblyName>ConsoleReferencePubSubClient</AssemblyName>
+    <PackageId>ConsoleReferencePubSubClient</PackageId>
+    <Company>OPC Foundation</Company>
+    <Description>Self-contained OPC UA Part 14 PubSub reference sample with three command-line-selectable modes (publisher, subscriber, external-server adapter bridge) built on the fluent + DI Host surface. Native AOT compatible.</Description>
+    <Copyright>Copyright © 2004-2026 OPC Foundation, Inc</Copyright>
+    <RootNamespace>Quickstarts.ConsoleReferencePubSubClient</RootNamespace>
+    <Nullable>enable</Nullable>
+    <IsPackable>false</IsPackable>
+    <PublishAot>true</PublishAot>
+    <!-- Opt into the root Directory.Build.targets no-op shape on
+         per-TFM CI matrix entries that pin CustomTestTarget to a
+         legacy TFM this sample cannot target. -->
+    <RestrictForLegacyTfm>true</RestrictForLegacyTfm>
+  </PropertyGroup>
+  <ItemGroup>
+    <ProjectReference Include="..\..\Libraries\Opc.Ua.Configuration\Opc.Ua.Configuration.csproj" />
+    <ProjectReference Include="..\..\Libraries\Opc.Ua.PubSub\Opc.Ua.PubSub.csproj" />
+    <ProjectReference Include="..\..\Libraries\Opc.Ua.PubSub.Udp\Opc.Ua.PubSub.Udp.csproj" />
+    <ProjectReference Include="..\..\Libraries\Opc.Ua.PubSub.Eth\Opc.Ua.PubSub.Eth.csproj" />
+    <ProjectReference Include="..\..\Libraries\Opc.Ua.PubSub.Mqtt\Opc.Ua.PubSub.Mqtt.csproj" />
+    <ProjectReference Include="..\..\Libraries\Opc.Ua.PubSub.Adapter\Opc.Ua.PubSub.Adapter.csproj" />
+  </ItemGroup>
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Extensions.Hosting" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" />
+    <PackageReference Include="System.CommandLine" />
+  </ItemGroup>
+  <ItemGroup>
+    <None Update="appsettings.json">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+    </None>
+  </ItemGroup>
+</Project>