PI SDK .NET Controls and Dialogs

This brief tutorial describes using the OSIsoft.PISDK.Controls managed controls. These are the common controls used in the PISDKUtility application.

  1. Create a new Windows Form application.
  2. Add a reference to the PI SDK Controls using the .NET references tab. Scroll to the OSIsoft.PISDKControls assembly. The assembly may appear twice if both the 32-bit and 64-bit PI SDK are installed. Both are MSIL assemblies, thus either will suffice. Note that the assembly is OSIsoft.PISDK.Controls and will show up in the references with that name.
  3. To use the connection manager dialog on a Windows Form, create a button control and for the code type:
    private void button1_Click(object sender, EventArgs e)
       OSIsoft.PISDKControls.CxnManagerDlg dlg = new OSIsoft.PISDKControls.CxnManagerDlg();
    The dialog shows a list of servers with connection status, but not the selected server's properites pane.
  4. To use the connection manager control on a Windows Form,
    1. Create a button control,
    2. Add a new Windows Form named CxnCtlForm,
    3. Double click the button on the main form and for the code type:
      private void button2_Click(object sender, EventArgs e)
         CxnCtlForm connect = new CxnCtlForm();
    4. As part of the form CxnCtlForm, insert the ConnectionManager control.
    Note: The control shows a list of servers with connection status and the currently selected server's properites pane.

Additional controls available are the MsgLogViewer, PIServerPickList, ServerProperties, PISnapShotCtl. The PISnapShotCtl control exposes the properties SelectedTagList and TagList that may allows this control to be used as a basic tag search dialog.

Additional dialogs available are the BufferingSetupForm and PISnapShotForm.

The ConnectionMgr object is available as a managed version of the COM Connection Object for PI Server login.

Enabling Operational Intelligence