Object Model
Syntax
| Visual Basic (Declaration) | |
|---|---|
Public MustInherit Class DataRegister Inherits RemotableObject Implements IPropertyInfo, IPropertyInfo2, IRemoteNotifyPropertyChanged, IRemoteNotifyPropertyInfoChanged | |
| C# | |
|---|---|
public abstract class DataRegister : RemotableObject, IPropertyInfo, IPropertyInfo2, IRemoteNotifyPropertyChanged, IRemoteNotifyPropertyInfoChanged | |
| C++/CLI | |
|---|---|
public ref class DataRegister abstract : public RemotableObject, IPropertyInfo, IPropertyInfo2, IRemoteNotifyPropertyChanged, IRemoteNotifyPropertyInfoChanged | |
Remarks
The software provides 20 data registers for storing and retrieving trace data. Data registers are stored in active memory for the current application session. The data registers are cleared when the application is closed. You can perform the following operations with data registers:
- Copy a trace into a data register
- Recall a saved trace (from disk) into a data register
- Display the contents of a data register
- Remove a data register
The DataRegister object represents one of the data registers in the DataRegisters collection.
There are eight data registers, D1 through D20. Each one holds a complete trace copied from a trace or recalled from a file. You can also determine whether a data register contains any data, and remove the register contents from memory.
The Trace.CopyToDataRegister and Trace.CopyToDataRegister methods copy trace data to a data register (by index or by name). The Trace.SaveFile method saves data to a file in a number of formats, including text, MATLAB, and SDF (binary). The RecallFile method recalls a file into a data register.
A data register is selected for display on a trace by using the Trace.DataName property. The list of available data names for data registers is returned by the TraceCollection.DataNamesDataRegister property. The Trace.DataName for a data register is the data register 1-based index prefaced with "D".
Requirements
Target Platforms: Windows 11 Professional or Enterprise; Windows 10 Professional, Enterprise, or Education (64-bit)