OPC Controls.NET Runtime Distribution

You can distribute all OPC Controls .NET components with your local and remote applications. These components will only connect to licensed OAS Services.

The Microsoft .NET Framework version 1.1 is required on all systems that will use the OPC Controls components developed with Visual Studio 2003.

The Microsoft .NET Framework version 2.0 is required on all systems that will use the OPC Controls components developed with Visual Studio 2005, 2008, or 2010.

The following files are required to be distributed with your application that are commonly found in the installation directory of Open Automation Software:

  • For .NET Framework 1.1 the installation directory is C:Program FilesEEIOPCSystems.NET.
  • For .NET Framework 2.0 the installation directory is C:Program FilesOpen Automation SoftwareOPCSystems.NET.

Include the following files in your application references as Local Copy:

  • OPCControls.dll
  • OPCSystemsInterface.dll
  • OPCSystemsBrowseComputers.dll

OPC Controls Data

The OPC Controls Data component is used to read and write values to Open Automation Software Tag Parameters.

Reading and writing to both local and remote OAS Service Tags simplifies the task of reading and writing OPC data and all of the connection handling to OPC Servers is performed by the OAS Service just as it does with all features of Open Automation Software.

If a Tag Parameter Source is defined to an OPC Item when the Tag Parameter is written to the OPC Item is also written to with the same value.

View the .NET Realtime Data Access section in Programmatic Interface topic for examples of reading and writing data.

OPC Controls Data 354

To add an OPC Controls Data component select the OPCControlsData component from the ToolBox and place it on any Windows Form of your choice.  Add OPC Controls Components to Visual Studio.NET to add the OPC Controls Data component to the ToolBox.

OPC Controls Read Values

Refer to the WinForm Example Code installed with Open Automation Software for a full example on how to read data from Open Automation Software Tags and DirectOPC Items.

To read values from the Open Automation Software involves one simple method to let the OAS Services which Tags you wish to read and one simple event receive all changes and updates to the Tags you wish to read.

Use the AddTag or AddTags as many times as you desire to subscribe to both local and remote OAS Services.

Dim Tags(2) As String
        Tags(0) = "Ramp.Value"
        Tags(1) = "Sine.Value"
        Tags(2) = "Random.Value"
        OpcControlsData.AddTags(Tags)

Use the ValuesChangedAll Event to receive the requested values continuously any time the values are requested or the values change.

Private Sub OpcControlsData_ValuesChangedAll(ByVal Tags() As String, ByVal Values() As Object, ByVal Qualities() As Boolean, ByVal TimeStamps() As Date) Handles OpcControlsData.ValuesChangedAll

Use the RemoveTag or RemoveTags as many times as you desire to unsubscribe to both local and remote OAS Services.

Dim Tags(2) As String
        Tags(0) = "Ramp.Value"
        Tags(1) = "Sine.Value"
        Tags(2) = "Random.Value"
        OpcControlsData.RemoveTags(Tags)

OPC Controls Write Values

Refer to the WinForm Example Code installed with Open Automation Software for a full example on how to write data to Open Automation Software.

To write values from the Open Automation Software involves one simple method to write the values, one simple method to let the OAS Services which Tags you wish to read to confirm the value was successful, and one simple event receive all changes and updates to the Tags you wish to read.

Use the AddTag or AddTags to subscribe to both local and remote OAS Services to receive back the value for confirmation.

OpcControlsData.AddTag("Write OPC Output.Value")

Use the WriteTag or WriteTags to send the desired values to the tags.

OpcControlsData.WriteTag("Write OPC Output.Value", 1.23)

Use the ValuesChangedAll Event to receive the requested values continuously to confirm the values have changed.

OPC Controls StatusBar

The OPC Controls StatusBar component performs exactly like the standard StatusBar component with additional properties to automatically update from any Open Automation Software Tag Parameter. For programmatic help refer to the OPCControls Help file.

OPC Controls StatusBar 353

To add an OPC Controls StatusBar select the OPCControlsStatusBar component from the ToolBox and place it on any Windows Form of your choice. See Add OPC Controls Components to Visual Studio.NET to add the OPC Controls StatusBar to the ToolBox.

OPC Controls StatusBar Properties

Refer to OPCControls help for all properties and members of the OPC Controls.NET components. All properties can be assigned in code; however no programming is required to use the properties.

The following properties can automatically be set by Open Automation Software Tag values.

Enabled

OPC Controls Label Properties 311

Location

OPC Controls Label Properties 314

Size

OPC Controls Label Properties 315

Tag

OPC Controls Label Properties 316

Text

OPC Controls Label Properties 317

Visible

OPC Controls Label Properties 318

OPC Controls TrackBar

The OPC Controls TrackBar component performs exactly like the standard TrackBar component with additional properties to automatically update from any Open Automation Software Tag Parameter. For programmatic help refer to the OPCControls Help file.

OPC Controls TrackBar 351

To add an OPC Controls TrackBar select the OPCControlsTrackBar component from the ToolBox and place it on any Windows Form of your choice. Add OPC Controls Components to Visual Studio.NET to add the OPC Controls TrackBar to the ToolBox.

OPC Controls TrackBar Properties

Refer to OPCControls help for all properties and members of the OPC Controls.NET components. All properties can be assigned in code; however no programming is required to use the properties.

Use the ValueOPCSystemsSetValue property to enable the ability to write to a Tag Parameter when the Mouse moves the TrackBar Value.  If the Tag Parameter is assigned to an OPC Item as a source the OPC Item will be written to with the value specified when the Mouse moves the OPC Controls TrackBar Value.

The following properties can automatically be set by Open Automation Software Tag values.

BackColor

OPC Controls Button Properties 320

Enabled

OPC Controls Button Properties 321

Location

OPC Controls Button Properties 324

Maximum

OPC Controls HScrollBar Properties 347

Minimum

OPC Controls HScrollBar Properties 348

Size

OPC Controls Button Properties 326

Tag

OPC Controls Button Properties 327

Text

OPC Controls PictureBox Properties 339

Value

OPC Controls TrackBar Properties 352

Visible

OPC Controls Button Properties 329

OPC Controls VScrollBar

The OPC Controls VScrollBar component performs exactly like the standard VScrollBar component with additional properties to automatically update from any Open Automation Software Tag Parameter.  For programmatic help refer to the OPCControls Help file.

OPC Controls VScrollBar 350

To add an OPC Controls VScrollBar select the OPCControlsVScrollBar component from the ToolBox and place it on any Windows Form of your choice. Add OPC Controls Components to Visual Studio.NET to add the OPC Controls VScrollBar to the ToolBox.

OPC Controls VScrollBar Properties

Refer to OPCControls help for all properties and members of the OPC Controls.NET components. All properties can be assigned in code; however no programming is required to use the properties.

Use the ValueOPCSystemsSetValue property to enable the ability to write to a Tag Parameter when the VScrollBar is scrolled. If the Tag Parameter is assigned to an OPC Item as a source the OPC Item will be written to with the value specified when the OPC Controls VScrollBar is scrolled.

The following properties can automatically be set by Open Automation Software Tag values.

Enabled

OPC Controls Button Properties 321

Location

OPC Controls Button Properties 324

Maximum

OPC Controls HScrollBar Properties 347

Minimum

OPC Controls HScrollBar Properties 348

Size

OPC Controls Button Properties 326

Tag

OPC Controls Button Properties 327

Text

OPC Controls PictureBox Properties 339

Value

OPC Controls HScrollBar Properties 349

Visible

OPC Controls Button Properties 329

OPC Controls HScrollBar

The OPC Controls HScrollBar component performs exactly like the standard HScrollBar component with additional properties to automatically update from any Open Automation Software Tag Parameter.  For programmatic help refer to the OPCControls Help file.

OPC Controls HScrollBar 346

To add an OPC Controls HScrollBar select the OPCControlsHScrollBar component from the ToolBox and place it on any Windows Form of your choice. Add OPC Controls Components to Visual Studio.NET to add the OPC Controls HScrollBar to the ToolBox.

OPC Controls HScrollBar Properties

Refer to OPCControls help for all properties and members of the OPC Controls.NET components. All properties can be assigned in code; however no programming is required to use the properties.

Use the ValueOPCSystemsSetValue property to enable the ability to write to a Tag Parameter when the HScrollBar is scrolled. If the Tag Parameter is assigned to an OPC Item as a source the OPC Item will be written to with the value specified when the OPC Controls HScrollBar is scrolled.

The following properties can automatically be set by Open Automation Software Tag values.

Enabled

OPC Controls Button Properties 321

Location

OPC Controls Button Properties 324

Maximum

OPC Controls HScrollBar Properties 347

Minimum

OPC Controls HScrollBar Properties 348

Size

OPC Controls Button Properties 326

Tag

OPC Controls Button Properties 327

Text

OPC Controls PictureBox Properties 339

Value

OPC Controls HScrollBar Properties 349

Visible

OPC Controls Button Properties 329

OPC Controls ComboBox

The OPC Controls ComboBox component performs exactly like the standard ComboBox component with additional properties to automatically update from any Open Automation Software Tag Parameter.  For programmatic help refer to the OPCControls Help file.

OPC Controls ComboBox 344

To add an OPC Controls ComboBox select the OPCControlsComboBox component from the ToolBox and place it on any Windows Form of your choice.  See Add OPC Controls Components to Visual Studio.NET to add the OPC Controls ComboBox to the ToolBox.

OPC Controls ComboBox Properties

Refer to OPCControls help for all properties and members of the OPC Controls.NET components. All properties can be assigned in code; however no programming is required to use the properties.

Use the SetValueOPCSystems property to enable the ability to write to a Tag Parameter when the ComboBox is clicked. If the Tag Parameter is assigned to an OPC Item as a source the OPC Item will be written to with the value specified when the OPC Controls ComboBox is clicked.

The following properties can automatically be set by Open Automation Software Tag values.

BackColor

OPC Controls Button Properties 320

Enabled

OPC Controls Button Properties 321

ForeColor

OPC Controls Button Properties 322

Location

OPC Controls Button Properties 324

SelectedIndex

OPC Controls ListBox Properties 342

SetValueOPCSystems

OPC Controls ListBox Properties 343

Size

OPC Controls Button Properties 326

Tag

OPC Controls Button Properties 327

Text

OPC Controls ComboBox Properties 345

Visible

OPC Controls Button Properties 329

OPC Controls ListBox

The OPC Controls ListBox component performs exactly like the standard ListBox component with additional properties to automatically update from any Open Automation Software Tag Parameter.  For programmatic help refer to the OPCControls Help file.

OPC Controls ListBox 341

To add an OPC Controls ListBox select the OPCControlsListBox component from the ToolBox and place it on any Windows Form of your choice.  See Add OPC Controls Components to Visual Studio.NET to add the OPC Controls ListBox to the ToolBox.

OPC Controls ListBox Properties

Refer to OPCControls help for all properties and members of the OPC Controls.NET components. All properties can be assigned in code; however no programming is required to use the properties.

Use the SetValueOPCSystems property to enable the ability to write to a Tag Parameter when the ListBox is clicked. If the Tag Parameter is assigned to an OPC Item as a source the OPC Item will be written to with the value specified when the OPC Controls ListBox is clicked.

The following properties can automatically be set by Open Automation Software Tag values.

BackColor

OPC Controls Button Properties 320

Enabled

OPC Controls Button Properties 321

ForeColor

OPC Controls Button Properties 322

Location

OPC Controls Button Properties 324

SelectedIndex

OPC Controls ListBox Properties 342

 

SetValueOPCSystems

OPC Controls ListBox Properties 343

Size

OPC Controls Button Properties 326

Tag

OPC Controls Button Properties 327

Text

OPC Controls PictureBox Properties 339

Visible

OPC Controls Button Properties 329

 

OPC Controls Panel

The OPC Controls Panel component performs exactly like the standard Panel component with additional properties to automatically update from any Open Automation Software Tag Parameter.  For programmatic help refer to the OPCControls Help file.

OPC Controls Panel 340

To add an OPC Controls Panel select the OPCControlsPanel component from the ToolBox and place it on any Windows Form of your choice.  See Add OPC Controls Components to Visual Studio.NET to add the OPC Controls GroupBox to the ToolBox.

OPC Controls Panel Properties

Refer to OPCControls help for all properties and members of the OPC Controls.NET components.  All properties can be assigned in code; however no programming is required to use the properties.

The following properties can automatically be set by Open Automation Software Tag values.

BackColor

OPC Controls Label Properties 310

Enabled

OPC Controls Label Properties 311

ForeColor

OPC Controls Label Properties 312

Location

OPC Controls Label Properties 314

Size

OPC Controls Label Properties 315

Tag

OPC Controls Label Properties 316

Text

OPC Controls PictureBox Properties 339

Visible

OPC Controls Label Properties 318

OPC Controls PictureBox

The OPC Controls PictureBox component performs exactly like the standard PictureBox component with additional properties to automatically update from any Open Automation Software Tag Parameter.  For programmatic help refer to the OPCControls Help file.

OPC Controls PictureBox 338

To add an OPC Controls PictureBox select the OPCControlsPictureBox component from the ToolBox and place it on any Windows Form of your choice.  See Add OPC Controls Components to Visual Studio.NET to add the OPC Controls PictureBox to the ToolBox.

OPC Controls PictureBox Properties

Refer to OPCControls help for all properties and members of the OPC Controls.NET components. All properties can be assigned in code; however no programming is required to use the properties.

The following properties can automatically be set by Open Automation Software Tag values.

BackColor

OPC Controls Label Properties 310

Enabled

OPC Controls Label Properties 311

Location

OPC Controls Label Properties 314

Size

OPC Controls Label Properties 315

Tag

OPC Controls Label Properties 316

Text

OPC Controls PictureBox Properties 339

Visible

OPC Controls Label Properties 318