Exports a session configuration to the specified file.

Syntax

Namespace: NationalInstruments.ModularInstruments.NIDCPower

public void ExportAttributeConfigurationFile(string filePath)

Remarks

You can export and import session attribute configurations only between NI-DCPower devices with identical model numbers and the same number of initialized channels.

This method verifies that the attributes you have configured for the session are valid. If the configuration is invalid, NI-DCPower returns an Ivi.Driver.IviCDriverException.

Supported Configurations

You can export and import the following configurations between NI-DCPower sessions:
  • Attribute configurations

  • Advanced sequences

Support for this Method

You must set the source mode to Sequence in order to configure or export and import advanced sequences.

Configuration exports from sessions created with the independent channel NIDCPower constructor cannot be imported into sessions created with deprecated NIDCPower constructors.

Note

Exporting and importing simple sequences between sessions in Sequence source mode is unsupported.

Channel Mapping Behavior

When importing and exporting configurations between NI-DCPower sessions that were initialized with different channels, the configurations of the exporting channels are mapped to the importing channels based on the order you specify in the resourceName input to the independent channel NIDCPower constructor.

Refer to Import/Export Attribute Configuration Mapping Behavior in the NI DC Power Supplies and SMUs Help for details.

Parameters

NameTypeDescription
filePathstring

The absolute path to a placeholder file you must create to contain the configuration you want to export. If you specify an empty or relative path, this method throws an exception. The default file extension is .nidcpowerconfig.

Exceptions

TypeDescription
System.ObjectDisposedException

The ExportAttributeConfigurationFile method was called after the associated NIDCPower object was disposed.

Ivi.Driver.IviCDriverException

The underlying NI-DCPower driver returned an error.