CreateIn(UADataVariable,String) Method

Creates and returns a data variable (with given name) in the specified parent data variable.

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
<NotNullAttribute()>
Public Overloads Shared Function CreateIn( _
   ByVal parentDataVariable As UADataVariable, _
   ByVal name As String _
) As UADataVariable

'Usage
 
Dim parentDataVariable As UADataVariable
Dim name As String
Dim value As UADataVariable
 
value = UADataVariable.CreateIn(parentDataVariable, name)

[NotNull()]
public static UADataVariable CreateIn( 
   UADataVariable parentDataVariable,
   string name
)

[NotNull()]
public:
static UADataVariable^ CreateIn( 
   UADataVariable^ parentDataVariable,
   String^ name
)

Parameters

parentDataVariable: The parent data variable in which the new data variable will be placed.
The value of this parameter cannot be null (Nothing in Visual Basic).
name: The name of the data variable.
The value of this parameter cannot be null (Nothing in Visual Basic).

Return Value

Returns the newly create data variable object.

This method never returns null (Nothing in Visual Basic).

Exceptions

Exception Description

Exception	Description
System.ArgumentNullException	A `null` reference (`Nothing` in Visual Basic) is passed to a method that does not accept it as a valid argument. This is a usage error, i.e. it will never occur (the exception will not be thrown) in a correctly written program. Your code should not catch this exception.

System.ArgumentNullException

A null reference (Nothing in Visual Basic) is passed to a method that does not accept it as a valid argument.

This is a usage error, i.e. it will never occur (the exception will not be thrown) in a correctly written program. Your code should not catch this exception.

Example

CSharp

// This example shows how sub-nodes of server nodes can be accessed by their node name using an indexer.
// You can use any OPC UA client, including our Connectivity Explorer and OpcCmd utility, to connect to the server. 
//
// Find all latest examples here: https://opclabs.doc-that.com/files/onlinedocs/OPCLabs-OpcStudio/Latest/examples.html .
// OPC client, server and subscriber examples in C# on GitHub: https://github.com/OPCLabs/Examples-OPCStudio-CSharp .
// Missing some example? Ask us for it on our Online Forums, https://www.opclabs.com/forum/index ! You do not have to own
// a commercial license in order to use Online Forums, and we reply to every post.

using System;
using OpcLabs.EasyOpc.UA;
using OpcLabs.EasyOpc.UA.NodeSpace;

namespace UAServerDocExamples._UAServerNode
{
    class Indexer
    {
        public static void Main1()
        {
            // Instantiate the server object.
            // By default, the server will run on endpoint URL "opc.tcp://localhost:48040/".
            var server = new EasyUAServer();

            // Define some nodes in the server.
            UADataVariable constantDataVariable = UADataVariable.CreateIn(server.Objects, "Constant").ConstantValue("abc");
            UADataVariable nestedConstantDataVariable = UADataVariable.CreateIn(constantDataVariable, "NestedConstant").ConstantValue(42);
            
            // Get the nested constant data variable.
            UAServerNode serverNode1 = server.Objects["Constant"]["NestedConstant"];
            Console.WriteLine(serverNode1);
        }
    }
}

Requirements

Target Platforms: .NET Framework: Windows 10 (selected versions), Windows 11 (selected versions), Windows Server 2016, Windows Server 2022; .NET: Linux, macOS, Microsoft Windows

Reference

UADataVariable Class
UADataVariable Members
Overload List
CreateIn Method

Documentation Home, Send Documentation Feedback. Technical Support