ScopeDriverUtility.ExportAttributeConfigurationFile Method
- Updated2023-09-06
- 2 minute(s) read
ScopeDriverUtilityExportAttributeConfigurationFile Method
Exports the attribute configuration of the session to the specified file.
Namespace: NationalInstruments.ModularInstruments.NIScope
Assembly: NationalInstruments.ModularInstruments.NIScope.Fx45 (in NationalInstruments.ModularInstruments.NIScope.Fx45.dll) Version: 2023
Syntax
public void ExportAttributeConfigurationFile( string filePath )
Public Sub ExportAttributeConfigurationFile ( filePath As String )
Parameters
- filePath
- Type: SystemString
The absolute path to the file to contain the exported attribute configuration. If you specify an empty or relative path, this method returns an error. The default file extension is .niscopeconfig.
Exceptions
| Exception | Condition |
|---|---|
| ObjectDisposedException | The ExportAttributeConfigurationFile(String) method was called after the associated NIScope object was disposed. |
| IviCDriverException | The underlying NI-SCOPE driver returned an error. |
Remarks
You can export and import session attribute configurations only between devices with identical model numbers, channel counts, and onboard memory sizes and between NI-SCOPE sessions with 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-SCOPE returns an error.
When importing and exporting configurations between NI-SCOPE sessions that were both initialized with multiple instruments, the configurations of the exporting instruments are mapped to the importing instruments in the order you specify in the "resourceName" input to the NIScope constructor.
For example, if your entry for "resourceName" is "PXI1Slot1,PXI1Slot2" for the exporting session and "PXI2Slot2,PXI2Slot3" for the importing session:
- The configuration exported from PXI1Slot1 is imported into PXI2Slot2.
- The configuration exported from PXI1Slot2 is imported into PXI2Slot3.
 Note |
|---|
| NI-SCOPE will return an error if the total number of channels initialized for the exporting session is not equal to the total number of channels initialized for the importing session. |