C# und .NET Neu

C# OPC UA Client Bibliothek für .NET

Durchsuche, lies, schreibe und abonniere die OPC UA Server von SPS-Steuerungen, SCADA-Systemen und Gateways aus C#, über eine signierte und verschlüsselte opc.tcp-Verbindung.

OPC UA Binary über opc.tcp
Sign und SignAndEncrypt bis Aes256_Sha256_RsaPss
Datenänderungs- und Ereignis-Subscriptions
Identitäten Anonymous, Benutzername und X.509

Enthalten in sgcWebSockets Enterprise (Delphi und .NET) und All-Access oder im eigenständigen Paket sgcIndustrial.

In C# lesen und abonnieren → · OPC UA FAQ →

C# OPC UA Client
using System;
using esegece.sgcWebSockets;

var opcua = new TsgcOPCUAClient();
opcua.EndpointUrl = "opc.tcp://192.168.1.60:4840";
opcua.Connect();
Console.WriteLine(opcua.ReadValue("ns=2;s=Line1.Temperature"));
opcua.WriteValue("ns=2;s=Line1.Setpoint", 75.5);
opcua.Disconnect();

Ein OPC UA Client für .NET-Anwendungen

Secure Channel, Session, Services und Subscriptions in einer Klasse, mit derselben API wie die Delphi-Komponente.

Der C# OPC UA Client in sgcWebSockets .NET ist TsgcOPCUAClient, Teil des Pakets esegece.sgcIndustrial, Namespace esegece.sgcWebSockets. Setze EndpointUrl, wähle SecurityPolicy und SecurityMode, rufe Connect auf und arbeite mit Node-IDs wie ns=2;s=Line1.Speed. ReadValue liefert den Wert als einfaches .NET-Objekt (typisierte Arrays, double[,] für eine Matrix), und WriteValue liest zuerst den Datentyp des Knotens, damit der Wert so kodiert wird, wie der Server es erwartet.

Jeder Service-Aufruf ist synchron und löst bei einem Fehler EsgcOPCUAError aus, dessen StatusCode den OPC UA Statuscode enthält. Subscriptions schieben Datenänderungen und Ereignisse über OnDataChange und OnEvent an deine Handler. Das Paket zielt auf .NET 8, .NET 9, .NET 10 und .NET Standard 2.0.

Services

GetEndpoints, Browse, BrowseNext, TranslateBrowsePath, Read, Write und Call.

Subscriptions

Datenänderungs-Items mit Deadband und Warteschlangengröße, Ereignis-Items mit Select- und Where-Klauseln.

Sicherheit

Basic256Sha256, Aes128_Sha256_RsaOaep und Aes256_Sha256_RsaPss im Modus Sign oder SignAndEncrypt.

Identitäten

Anonymous, Benutzername und Passwort oder ein X.509-Benutzerzertifikat.

OPC UA in C#, Schritt für Schritt

Referenziere das Paket esegece.sgcIndustrial, verbinde dich und lies, durchsuche oder abonniere dann. Jedes Beispiel auf dieser Seite lässt sich gegen .NET 8 kompilieren.

using System;
using esegece.sgcWebSockets;

var opcua = new TsgcOPCUAClient();
opcua.EndpointUrl = "opc.tcp://192.168.1.60:4840";
opcua.Connect();
try
{
    Console.WriteLine("Speed: " + opcua.ReadValue("ns=2;s=Line1.Speed"));
    // write with an explicit built-in type
    opcua.WriteValue("ns=2;s=Line1.Mode", (ushort)2, TsgcOPCUABuiltInType.uabtUInt16);
}
catch (EsgcOPCUAError e)
{
    Console.WriteLine($"Status 0x{e.StatusCode:X8}: {e.Message}");
}
finally
{
    opcua.Disconnect();
}
using System;
using esegece.sgcWebSockets;
using static esegece.sgcWebSockets.sgcOPCUA_Types;

var opcua = new TsgcOPCUAClient();
opcua.EndpointUrl = "opc.tcp://192.168.1.60:4840";
opcua.Connect();
// i=85 is the Objects folder
foreach (TsgcOPCUAReferenceDescription item in opcua.Browse("i=85"))
    Console.WriteLine(item.DisplayName.Text + " = " + sgcOPCUANodeIdToString(item.NodeId.NodeId));
// resolve a browse path to a node id
TsgcOPCUANodeId speed = opcua.TranslateBrowsePath("i=85", "/2:Line1/2:Speed");
Console.WriteLine(sgcOPCUANodeIdToString(speed));
// call a method with two Int32 arguments
TsgcOPCUAVariant[] outputs = opcua.Call("ns=2;s=Methods", "ns=2;s=Methods.Add", new[] {
    sgcOPCUAVariantSimple(TsgcOPCUABuiltInType.uabtInt32, 2),
    sgcOPCUAVariantSimple(TsgcOPCUABuiltInType.uabtInt32, 3) });
Console.WriteLine("Result: " + outputs[0].Value);
opcua.Disconnect();
using System;
using esegece.sgcWebSockets;
using static esegece.sgcWebSockets.sgcOPCUA_Encoding;

class LineMonitor
{
    public void Start(TsgcOPCUAClient aClient)
    {
        aClient.OnDataChange += OnOPCUADataChange;
        aClient.OnEvent += OnOPCUAEvent;
        TsgcOPCUASubscription subscription = aClient.CreateSubscription(500);
        // report changes larger than 0.5 only
        aClient.AddMonitoredItem(subscription, "ns=2;s=Line1.Temperature", 250, 1, true,
            TsgcOPCUADeadbandType.uadbtAbsolute, 0.5);
        // i=2253 is the Server object, which reports the events of the whole server
        aClient.AddEventMonitoredItem(subscription, "i=2253", new[] { "Message", "Severity", "SourceName" });
    }

    void OnOPCUADataChange(object Sender, TsgcOPCUASubscription aSubscription,
        TsgcOPCUAMonitoredItem aMonitoredItem, TsgcOPCUADataValue aValue)
    {
        Console.WriteLine("Temperature: " + aValue.Value.Value);
    }

    void OnOPCUAEvent(object Sender, TsgcOPCUASubscription aSubscription,
        TsgcOPCUAMonitoredItem aMonitoredItem, TsgcOPCUAVariant[] aEventFields)
    {
        // the fields arrive in the order of the select clauses
        Console.WriteLine(sgcOPCUAVariantToValue(aEventFields[2]) + " (" +
            sgcOPCUAVariantToValue(aEventFields[1]) + "): " + sgcOPCUAVariantToValue(aEventFields[0]));
    }
}
using System.IO;
using System.Linq;
using esegece.sgcWebSockets;

class SecureLine
{
    // DER bytes of the server certificate you trust
    readonly byte[] FTrusted = File.ReadAllBytes(@"C:\pki\trusted\server.der");

    public TsgcOPCUAClient Connect()
    {
        var opcua = new TsgcOPCUAClient();
        opcua.EndpointUrl = "opc.tcp://192.168.1.60:4840";
        opcua.SecurityPolicy = TsgcOPCUASecurityPolicy.opcspAes256_Sha256_RsaPss;
        opcua.SecurityMode = TsgcOPCUAMessageSecurityMode.opcsmSignAndEncrypt;
        // no certificate files set: the application certificate is created in memory
        // X.509 user identity
        opcua.Authentication.AuthenticationType = TsgcOPCUAAuthenticationType.opcatCertificate;
        opcua.Authentication.CertificateFile = @"C:\pki\user\operator.der";
        opcua.Authentication.PrivateKeyFile = @"C:\pki\user\operator.pem";
        opcua.OnValidateServerCertificate += OnOPCUAValidateServerCertificate;
        opcua.WatchDog.Enabled = true;   // reconnect after a network drop
        opcua.Connect();
        return opcua;
    }

    void OnOPCUAValidateServerCertificate(object Sender, byte[] aCertificate, ref bool aAccept)
    {
        aAccept = aCertificate != null && aCertificate.SequenceEqual(FTrusted);
    }
}

Die Service-Aufrufe sind synchron. Rufe sie in einer WinForms-, WPF- oder ASP.NET-Anwendung aus einem Worker-Thread oder innerhalb von Task.Run auf. Die Subscription-Ereignisse werden über NotifyEvents ausgelöst: im UI-Thread, falls vorhanden, sonst der Reihe nach im Thread-Pool.

Unterstützte OPC UA Services

Einfache Überladungen nehmen Node-ID-Strings; vollständige Überladungen nehmen die Request-Klassen der Spezifikation.

Service SetServiceC#-Methode
DiscoveryGetEndpointsGetEndpoints
ViewBrowse, BrowseNextBrowse, BrowseNext
ViewTranslateBrowsePathsToNodeIdsTranslateBrowsePath
AttributeReadRead, ReadValue
AttributeWriteWrite, WriteValue
MethodeCallCall
SubscriptionCreateSubscription, DeleteSubscriptions, SetPublishingModeCreateSubscription, DeleteSubscription, SetPublishingMode
MonitoredItemCreateMonitoredItems, ModifyMonitoredItems, DeleteMonitoredItemsAddMonitoredItem, AddEventMonitoredItem, ModifyMonitoredItem, RemoveMonitoredItem
SubscriptionPublish, Republish, TransferSubscriptionsVom Client erledigt: OnDataChange, OnEvent, OnKeepAlive, WatchDog

Ein OPC UA Client für den Produktiveinsatz

Publish-Schleife erledigt

Der Client hält genügend Publish-Requests in Bearbeitung, bestätigt jede Benachrichtigung, fordert den Server auf, eine verlorene Nachricht erneut zu senden, und verwirft Duplikate, sodass deine Handler jeden Wert nur einmal sehen.

Deadband und Warteschlangen

AddMonitoredItem legt Abtastintervall, Warteschlangengröße und ein absolutes oder prozentuales Deadband pro Knoten fest. ModifyMonitoredItem ändert sie später und SetPublishingMode pausiert eine Subscription.

Ereignisse und Alarme

AddEventMonitoredItem liefert die von dir gewählten Ereignisfelder zurück, etwa Message, Severity und SourceName, gefiltert durch eine optionale Where-Klausel.

Zertifikate

Das Anwendungszertifikat wird aus DER- oder PEM-Dateien geladen, bei der ersten Verbindung erstellt und gespeichert oder im Speicher erstellt. Ein Serverzertifikat wird abgelehnt, sofern OnValidateServerCertificate es nicht akzeptiert.

Automatische Wiederverbindung

Nach einem Netzwerkausfall aktiviert WatchDog zuerst dieselbe Session wieder und sendet die verpassten Benachrichtigungen erneut. Ist die Session verloren, öffnet er eine neue und überträgt oder erstellt die Subscriptions neu. OnReconnect meldet, welcher Weg genommen wurde, und deine Subscription-Objekte bleiben gültig.

Dieselbe API wie in Delphi

Klassen-, Eigenschafts-, Methoden- und Ereignisnamen stimmen mit der Delphi- und C++Builder-Komponente überein, sodass ein Team ein Design für beide Plattformen nutzen kann.

Teil von sgcWebSockets Enterprise

Der OPC UA Client ist in sgcWebSockets Enterprise (Delphi und .NET) und All-Access enthalten, im Paket esegece.sgcIndustrial neben den Serial-Port- und Modbus-Komponenten. Vergleiche die Editionen auf der Preisseite (Registerkarte .NET) oder in der .NET-Funktionsmatrix.

Er wird gegen einen Referenzserver auf Basis von asyncua getestet, einer unabhängigen Open-Source-Implementierung von OPC UA: alle elf Endpunkte (jede Policy und jeder Modus), die drei Identitätstypen, das Durchsuchen mit Continuation Points, das Lesen von 18 eingebauten Typen mit Arrays und einer Matrix, Methodenaufrufe, Deadband- und Ereignis-Subscriptions sowie ein zweiminütiger Publish-Lauf ohne verlorene oder doppelte Nachricht.

Fragen zu C# OPC UA

Erstelle einen TsgcOPCUAClient, setze EndpointUrl, rufe Connect() auf und dann ReadValue("ns=2;s=Line1.Speed"). Es liefert ein object mit dem .NET-Typ des Werts. Read liest mehrere Knoten und Attribute in einem Aufruf.

Rufe CreateSubscription mit dem Publishing-Intervall auf, füge Knoten mit AddMonitoredItem hinzu und behandle OnDataChange. Ein Deadband an jedem Item hält kleine Änderungen von deinem Handler fern.

Basic256Sha256, Aes128_Sha256_RsaOaep und Aes256_Sha256_RsaPss im Modus Sign oder SignAndEncrypt, dazu die veralteten Basic128Rsa15 und Basic256 für ältere Server sowie None für Testaufbauten.

Behandle OnValidateServerCertificate und setze aAccept nur für die Zertifikate auf true, denen du vertraust, zum Beispiel indem du die DER-Bytes mit einer gespeicherten Kopie vergleichst. Ohne den Handler wird jede gesicherte Verbindung abgelehnt, es sei denn, AutoAcceptServerCertificate ist zum Testen gesetzt.

Der Client löst OnError und OnDisconnect aus. Mit WatchDog.Enabled = true versucht er es dann alle WatchDog.Interval Sekunden erneut (standardmäßig 10, WatchDog.Attempts 0 bedeutet keine Begrenzung). Er aktiviert dieselbe Session wieder, wenn der Server sie noch hat, andernfalls öffnet er eine neue Session und überträgt oder erstellt die Subscriptions neu. OnReconnect meldet, welcher Weg genommen wurde, und deine Subscription-Objekte bleiben gültig.

Das Paket esegece.sgcIndustrial zielt auf .NET 8, .NET 9, .NET 10 und .NET Standard 2.0, läuft also auch unter .NET Framework 4.8.

Der OPC UA Client ist in sgcWebSockets Enterprise (Delphi und .NET) und All-Access oder im eigenständigen Paket sgcIndustrial enthalten. Nicht enthalten sind ein OPC UA Server, die Transporte HTTPS, JSON und WebSocket, HistoryRead, PubSub, Reverse Connect und der Global Discovery Server.

Mehr zu sgcWebSockets .NET

Industrielle Komponenten

Serial Port, Modbus und OPC UA, mit der vollständigen Komponentenreferenz.

C# Modbus TCP und RTU

Modbus-Clients und -Server für die Geräte neben deinen OPC UA Servern.

C# MQTT Client

Leite OPC UA Datenänderungen aus derselben Anwendung an einen MQTT-Broker weiter.

Auch für Delphi und C++Builder

Derselbe OPC UA Client, mit denselben Klassen- und Methodennamen und derselben WatchDog-Wiederverbindung.

Bestes Preis-Leistungs-Verhältnis: All-AccessAlle eSeGeCe-Produkte, inklusive Premium-Support, ab €1,059 pro Jahr.
All-Access-Preise ansehen

Lies deinen ersten OPC UA Knoten aus C#

Enthalten in sgcWebSockets Enterprise (Delphi und .NET) und All-Access oder im eigenständigen Paket sgcIndustrial.