NI-DCPower .NET fx40 API Reference

Table of Contents

DCPowerDriverUtility.ExportAttributeConfigurationFile Method

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

DCPowerDriverUtilityExportAttributeConfigurationFile Method

Exports a session configuration to the specified file.

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

Syntax

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

Parameters

filePath
Type: SystemString
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

ExceptionCondition
ObjectDisposedException The ExportAttributeConfigurationFile(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 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 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 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