C# et .NET Nouveau

Bibliothèque client OPC UA C# pour .NET

Parcours, lis, écris et abonne-toi aux serveurs OPC UA des automates, systèmes SCADA et passerelles depuis C#, sur une connexion opc.tcp signée et chiffrée.

OPC UA binaire sur opc.tcp
Sign et SignAndEncrypt jusqu'à Aes256_Sha256_RsaPss
Abonnements aux changements de données et aux événements
Identités Anonymous, nom d'utilisateur et X.509

Inclus dans sgcWebSockets Enterprise (Delphi et .NET) et All-Access, ou dans le pack autonome sgcIndustrial.

Lire et s'abonner en C# → · FAQ OPC UA →

Client OPC UA C#
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();

Un client OPC UA pour les applications .NET

Canal sécurisé, session, services et abonnements dans une seule classe, avec la même API que le composant Delphi.

Le client OPC UA C# de sgcWebSockets .NET est TsgcOPCUAClient, dans le paquet esegece.sgcIndustrial, espace de noms esegece.sgcWebSockets. Renseigne EndpointUrl, choisis SecurityPolicy et SecurityMode, appelle Connect et travaille avec des identifiants de nœuds comme ns=2;s=Line1.Speed. ReadValue renvoie la valeur sous forme d'objet .NET simple (tableaux typés, double[,] pour une matrice), et WriteValue lit d'abord le type de données du nœud afin que la valeur soit encodée comme le serveur l'attend.

Chaque appel de service est synchrone et lève EsgcOPCUAError, dont StatusCode contient le code d'état OPC UA, en cas d'échec. Les abonnements poussent les changements de données et les événements vers tes gestionnaires via OnDataChange et OnEvent. Le paquet cible .NET 8, .NET 9, .NET 10 et .NET Standard 2.0.

Services

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

Abonnements

Éléments de changement de données avec zone morte et taille de file, éléments d'événement avec clauses select et where.

Sécurité

Basic256Sha256, Aes128_Sha256_RsaOaep et Aes256_Sha256_RsaPss en mode Sign ou SignAndEncrypt.

Identités

Anonyme, nom d'utilisateur et mot de passe, ou certificat utilisateur X.509.

OPC UA en C#, pas à pas

Référence le paquet esegece.sgcIndustrial, connecte-toi, puis lis, parcours ou abonne-toi. Chaque exemple de cette page compile avec .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);
    }
}

Les appels de service sont synchrones. Dans une application WinForms, WPF ou ASP.NET, appelle-les depuis un thread de travail ou dans Task.Run. Les événements d'abonnement sont déclenchés via NotifyEvents : sur le thread d'interface s'il y en a un, sinon dans l'ordre sur le pool de threads.

Services OPC UA pris en charge

Les surcharges simples prennent des chaînes d'identifiants de nœuds ; les surcharges complètes prennent les classes de requête de la spécification.

Ensemble de servicesServiceMéthode C#
DiscoveryGetEndpointsGetEndpoints
ViewBrowse, BrowseNextBrowse, BrowseNext
ViewTranslateBrowsePathsToNodeIdsTranslateBrowsePath
AttributeReadRead, ReadValue
AttributeWriteWrite, WriteValue
MéthodeCallCall
SubscriptionCreateSubscription, DeleteSubscriptions, SetPublishingModeCreateSubscription, DeleteSubscription, SetPublishingMode
MonitoredItemCreateMonitoredItems, ModifyMonitoredItems, DeleteMonitoredItemsAddMonitoredItem, AddEventMonitoredItem, ModifyMonitoredItem, RemoveMonitoredItem
SubscriptionPublish, Republish, TransferSubscriptionsGéré par le client : OnDataChange, OnEvent, OnKeepAlive, WatchDog

Un client OPC UA conçu pour la production

Boucle de publication gérée

Le client garde assez de requêtes Publish en vol, acquitte chaque notification, demande au serveur de republier un message perdu et écarte les doublons, si bien que tes gestionnaires voient chaque valeur une seule fois.

Zone morte et files

AddMonitoredItem définit l'intervalle d'échantillonnage, la taille de la file et une zone morte absolue ou en pourcentage pour chaque nœud. ModifyMonitoredItem les change plus tard et SetPublishingMode met un abonnement en pause.

Événements et alarmes

AddEventMonitoredItem renvoie les champs d'événement que tu sélectionnes, comme Message, Severity et SourceName, filtrés par une clause where facultative.

Certificats

Le certificat d'application est chargé depuis des fichiers DER ou PEM, créé et enregistré à la première connexion, ou créé en mémoire. Un certificat de serveur est rejeté à moins que OnValidateServerCertificate ne l'accepte.

Reconnexion automatique

Après une coupure réseau, WatchDog réactive d'abord la même session et republie les notifications manquées. Si la session a disparu, il en ouvre une nouvelle et transfère ou recrée les abonnements. OnReconnect indique quel chemin a été suivi, et tes objets d'abonnement restent valides.

La même API que Delphi

Les noms de classes, de propriétés, de méthodes et d'événements correspondent à ceux du composant Delphi et C++Builder, si bien qu'une équipe peut partager une même conception sur les deux plateformes.

Inclus dans sgcWebSockets Enterprise

Le client OPC UA est inclus dans sgcWebSockets Enterprise (Delphi et .NET) et All-Access, dans le paquet esegece.sgcIndustrial à côté des composants port série et Modbus. Compare les éditions sur la page des tarifs (onglet .NET) ou dans la matrice des fonctionnalités .NET.

Il est testé contre un serveur de référence construit sur asyncua, une implémentation OPC UA open source indépendante : les onze points d'accès (chaque politique et chaque mode), les trois types d'identité, la navigation avec points de continuation, la lecture de 18 types intégrés avec tableaux et matrice, les appels de méthodes, les abonnements avec zone morte et aux événements, et une exécution de publication de deux minutes sans message perdu ni dupliqué.

Questions sur le client OPC UA C#

Crée un TsgcOPCUAClient, renseigne EndpointUrl, appelle Connect() puis ReadValue("ns=2;s=Line1.Speed"). Il renvoie un object avec le type .NET de la valeur. Read lit plusieurs nœuds et attributs en un seul appel.

Appelle CreateSubscription avec l'intervalle de publication, ajoute les nœuds avec AddMonitoredItem et gère OnDataChange. Une zone morte sur chaque élément garde les petits changements hors de ton gestionnaire.

Basic256Sha256, Aes128_Sha256_RsaOaep et Aes256_Sha256_RsaPss en mode Sign ou SignAndEncrypt, plus Basic128Rsa15 et Basic256 (dépréciés) pour les anciens serveurs, et None pour les bancs de test.

Gère OnValidateServerCertificate et mets aAccept à true uniquement pour les certificats auxquels tu fais confiance, par exemple en comparant les octets DER avec une copie que tu as enregistrée. Sans ce gestionnaire, toute connexion sécurisée est rejetée, sauf si AutoAcceptServerCertificate est activé pour les tests.

Le client déclenche OnError et OnDisconnect. Avec WatchDog.Enabled = true, il réessaie ensuite toutes les WatchDog.Interval secondes (10 par défaut, WatchDog.Attempts à 0 signifie aucune limite). Il réactive la même session si le serveur la possède encore, sinon il ouvre une nouvelle session et transfère ou recrée les abonnements. OnReconnect indique quel chemin a été suivi, et tes objets d'abonnement restent valides.

Le paquet esegece.sgcIndustrial cible .NET 8, .NET 9, .NET 10 et .NET Standard 2.0, il fonctionne donc aussi sur .NET Framework 4.8.

Le client OPC UA est inclus dans sgcWebSockets Enterprise (Delphi et .NET) et All-Access, ou dans le pack autonome sgcIndustrial. Il n'inclut pas de serveur OPC UA, ni les transports HTTPS, JSON et WebSocket, HistoryRead, PubSub, Reverse Connect et le Global Discovery Server.

Plus sur sgcWebSockets .NET

Composants industriels

Port série, Modbus et OPC UA, avec la référence complète des composants.

Modbus TCP et RTU C#

Des clients et serveurs Modbus pour les appareils à côté de tes serveurs OPC UA.

Client MQTT C#

Transmets les changements de données OPC UA vers un broker MQTT depuis la même application.

Aussi pour Delphi et C++Builder

Le même client OPC UA, avec les mêmes noms de classes et de méthodes et la même reconnexion WatchDog.

Meilleur rapport qualité-prix : All-AccessTous les produits eSeGeCe, Support Premium inclus, à partir de €1,059/an.
Voir les tarifs All-Access

Lis ton premier nœud OPC UA depuis C#

Inclus dans sgcWebSockets Enterprise (Delphi et .NET) et All-Access, ou dans le pack autonome sgcIndustrial.