C# en .NET Nieuw

C# OPC UA-clientbibliotheek voor .NET

Browse, lees, schrijf en abonneer op de OPC UA-servers van PLC's, SCADA-systemen en gateways vanuit C#, over een ondertekende en versleutelde opc.tcp-verbinding.

OPC UA binary over opc.tcp
Sign en SignAndEncrypt tot en met Aes256_Sha256_RsaPss
Subscriptions voor datawijzigingen en events
Anonieme, gebruikersnaam- en X.509-identiteiten

Inbegrepen in sgcWebSockets Enterprise (Delphi en .NET) en All-Access, of in het standalone pakket sgcIndustrial.

Lezen en abonneren in C# → · 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();

Een OPC UA-client voor .NET-toepassingen

Secure channel, sessie, services en subscriptions in één klasse, met dezelfde API als de Delphi-component.

De C# OPC UA-client in sgcWebSockets .NET is TsgcOPCUAClient, onderdeel van het pakket esegece.sgcIndustrial, namespace esegece.sgcWebSockets. Stel EndpointUrl in, kies SecurityPolicy en SecurityMode, roep Connect aan en werk met node-id's zoals ns=2;s=Line1.Speed. ReadValue geeft de waarde terug als een gewoon .NET-object (getypeerde arrays, double[,] voor een matrix), en WriteValue leest eerst het datatype van de node zodat de waarde wordt gecodeerd zoals de server verwacht.

Elke service-aanroep is synchroon en geeft EsgcOPCUAError, waarvan StatusCode de OPC UA-statuscode bevat, als ze mislukt. Subscriptions sturen datawijzigingen en events naar je handlers via OnDataChange en OnEvent. Het pakket richt zich op .NET 8, .NET 9, .NET 10 en .NET Standard 2.0.

Services

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

Abonnementen

Data change-items met deadband en wachtrijgrootte, event-items met select- en where-clausules.

Beveiliging

Basic256Sha256, Aes128_Sha256_RsaOaep en Aes256_Sha256_RsaPss in de modus Sign of SignAndEncrypt.

Identiteiten

Anoniem, gebruikersnaam en wachtwoord, of een X.509-gebruikerscertificaat.

OPC UA in C#, stap voor stap

Verwijs naar het pakket esegece.sgcIndustrial, verbind, en lees, browse of abonneer daarna. Elk voorbeeld op deze pagina compileert met .NET 8.

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);
    }
}

De service-aanroepen zijn synchroon. Roep ze in een WinForms-, WPF- of ASP.NET-toepassing aan vanuit een worker-thread of binnen Task.Run. De subscription-events worden afgeleverd via NotifyEvents: op de UI-thread als die er is, anders op volgorde op de thread pool.

Ondersteunde OPC UA-services

Eenvoudige overloads nemen node-id-strings; volledige overloads nemen de request-klassen uit de specificatie.

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, TransferSubscriptionsDoor de client afgehandeld: OnDataChange, OnEvent, OnKeepAlive, WatchDog

Een OPC UA-client gebouwd voor productie

Publish-lus afgehandeld

De client houdt voldoende Publish-verzoeken in omloop, bevestigt elke notificatie, vraagt de server een verloren bericht opnieuw te publiceren en verwijdert duplicaten, zodat je handlers elke waarde één keer zien.

Deadband en wachtrijen

AddMonitoredItem stelt per node het sampling-interval, de wachtrijgrootte en een absolute of procentuele deadband in. ModifyMonitoredItem wijzigt ze later en SetPublishingMode pauzeert een subscription.

Events en alarmen

AddEventMonitoredItem geeft de eventvelden terug die je selecteert, zoals Message, Severity en SourceName, gefilterd door een optionele where-clausule.

Certificaten

Het applicatiecertificaat wordt geladen uit DER- of PEM-bestanden, bij de eerste verbinding aangemaakt en opgeslagen, of in het geheugen aangemaakt. Een servercertificaat wordt geweigerd tenzij OnValidateServerCertificate het accepteert.

Automatisch opnieuw verbinden

Na een netwerkonderbreking activeert WatchDog eerst dezelfde sessie opnieuw en publiceert de gemiste notificaties opnieuw. Is de sessie verdwenen, dan opent het een nieuwe en draagt de subscriptions over of maakt ze opnieuw aan. OnReconnect meldt welk pad is gevolgd, en je subscription-objecten blijven geldig.

Dezelfde API als Delphi

Klasse-, eigenschap-, methode- en eventnamen komen overeen met de Delphi- en C++Builder-component, zodat een team één ontwerp over beide platforms kan delen.

Onderdeel van sgcWebSockets Enterprise

De OPC UA-client is inbegrepen in sgcWebSockets Enterprise (Delphi en .NET) en All-Access, in het pakket esegece.sgcIndustrial naast de seriële poort- en Modbus-componenten. Vergelijk de edities op de prijzenpagina (tabblad .NET) of in de .NET-functiematrix.

Hij is getest tegen een referentieserver gebouwd op asyncua, een onafhankelijke open-source OPC UA-implementatie: alle elf endpoints (elk beleid en elke modus), de drie identiteitstypen, browsen met continuation points, het lezen van 18 ingebouwde types met arrays en een matrix, methode-aanroepen, deadband- en event-subscriptions en een publicatierun van twee minuten zonder verloren of dubbel bericht.

C# OPC UA-vragen

Maak een TsgcOPCUAClient, stel EndpointUrl in, roep Connect() aan en daarna ReadValue("ns=2;s=Line1.Speed"). Het geeft een object terug met het .NET-type van de waarde. Read leest meerdere nodes en attributen in één aanroep.

Roep CreateSubscription aan met het publicatie-interval, voeg nodes toe met AddMonitoredItem en handel OnDataChange af. Een deadband op elk item houdt kleine wijzigingen uit je handler.

Basic256Sha256, Aes128_Sha256_RsaOaep en Aes256_Sha256_RsaPss in de modus Sign of SignAndEncrypt, plus de afgeraden Basic128Rsa15 en Basic256 voor oudere servers, en None voor testopstellingen.

Handel OnValidateServerCertificate af en zet aAccept alleen op true voor de certificaten die je vertrouwt, bijvoorbeeld door de DER-bytes te vergelijken met een kopie die je hebt opgeslagen. Zonder de handler wordt elke beveiligde verbinding geweigerd, tenzij AutoAcceptServerCertificate voor tests is ingesteld.

De client activeert OnError en OnDisconnect. Met WatchDog.Enabled = true probeert hij het daarna elke WatchDog.Interval seconden opnieuw (standaard 10, WatchDog.Attempts 0 betekent geen limiet). Hij activeert dezelfde sessie opnieuw als de server die nog heeft, anders opent hij een nieuwe sessie en draagt de subscriptions over of maakt ze opnieuw aan. OnReconnect meldt welk pad is gevolgd, en je subscription-objecten blijven geldig.

Het pakket esegece.sgcIndustrial richt zich op .NET 8, .NET 9, .NET 10 en .NET Standard 2.0, zodat het ook op .NET Framework 4.8 draait.

De OPC UA-client is inbegrepen in sgcWebSockets Enterprise (Delphi en .NET) en All-Access, of in het standalone pakket sgcIndustrial. Hij bevat geen OPC UA-server, de HTTPS-, JSON- en WebSocket-transporten, HistoryRead, PubSub, Reverse Connect en de Global Discovery Server.

Meer over sgcWebSockets .NET

Industriële componenten

Seriële poort, Modbus en OPC UA, met de volledige componentreferentie.

C# Modbus TCP en RTU

Modbus-clients en -servers voor de apparaten naast je OPC UA-servers.

C# MQTT-client

Stuur OPC UA-datawijzigingen vanuit dezelfde toepassing door naar een MQTT-broker.

Ook voor Delphi en C++Builder

Dezelfde OPC UA-client, met dezelfde klasse- en methodenamen en dezelfde WatchDog-herverbinding.

De beste deal: All-AccessElk eSeGeCe-product, inclusief Premium-ondersteuning, vanaf €1,059 per jaar.
Bekijk de All-Access-prijzen

Lees je eerste OPC UA-node vanuit C#

Inbegrepen in sgcWebSockets Enterprise (Delphi en .NET) en All-Access, of in het standalone pakket sgcIndustrial.