NI-DCPower .NET fx40 API Reference

Table of Contents

DCPowerDriverUtility.ImportAttributeConfigurationFile Method

  • Updated2024-01-04
  • 2 minute(s) read
DCPowerDriverUtility.ImportAttributeConfigurationFile Method

DCPowerDriverUtilityImportAttributeConfigurationFile Method

Imports a configuration to the session from the specified file.

Namespace:  NationalInstruments.ModularInstruments.NIDCPower
Assembly:  NationalInstruments.ModularInstruments.NIDCPower.Fx40 (in NationalInstruments.ModularInstruments.NIDCPower.Fx40.dll) Version: 2023

Syntax

public void ImportAttributeConfigurationFile(
	string filePath
)
Public Sub ImportAttributeConfigurationFile ( 
	filePath As String
)

Parameters

filePath
Type: SystemString
The absolute path to the file that contains the configuration to import. If you specify an empty or relative path, this method throws an exception. The default file extension is .nidcpowerconfig.

Exceptions

ExceptionCondition
ObjectDisposedException The ImportAttributeConfigurationFile(String) method was called after the associated NIDCPower object was disposed.
IviCDriverException The underlying NI-DCPower driver returned an error.

Remarks

You can export and import session attribute configurations only between NI-DCPower devices with identical model numbers and the same number of configured channels.
Note Note
You cannot call this method while the session is in the Running state.

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 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.

See Also

Log in to get a better experience