Simulink.data.dictionary.Entry

配置数据字典条目

全页展开

说明

Simulink.data.dictionary.Entry 类的一个对象表示数据字典的一个条目。该对象允许您执行诸如为该条目赋值或更改条目名称之类的操作。

注意

对于涉及模型工作区、Simulink® 数据字典（“设计数据”分区）或 MAT 文件的最常见数据管理任务，推荐使用 Simulink.data.DataConnection 对象提供的函数，而不是特定于数据源的函数。这些对象函数提供通用的命令行界面，可以用更少的代码行来管理数据。使用 Simulink.data.connect 函数创建到数据源的连接，然后使用 Simulink.data.DataConnection 对象提供的通用函数集。对于特定于数据源的任务，例如删除或添加引用数据字典，请创建一个特定于数据源的对象，然后使用该对象提供的函数来管理您的数据源。有关详细信息，请参阅Manage Design Data for Simulink Models Programmatically。

您必须创建一个表示包含目标条目的数据字典分区的 Simulink.data.dictionary.Section 对象，才能创建新的 Simulink.data.dictionary.Entry 对象。不过，一旦创建，Simulink.data.dictionary.Entry 对象就独立于 Simulink.data.dictionary.Section 对象而存在。使用函数 getSection 创建一个 Simulink.data.dictionary.Section 对象。

创建对象

语法

描述

函数 addEntry、getEntry 和 find 创建 Simulink.data.dictionary.Entry 对象。

属性

全部展开

包含数据字典的文件名，指定为字符向量。对此属性所做的更改会影响所表示的数据字典条目。

示例: 'myDictionary.sldd'

数据类型: char

上次修改条目的日期和时间，以采用协调世界时 (UTC) 的字符向量形式返回。此属性是只读的。

修改条目的最后一个用户的名称，以字符向量形式返回。此属性是只读的。

条目的名称，指定为字符向量。对此属性所做的更改会影响所表示的数据字典条目。

数据类型: char

条目的状态，以 'New'、'Modified'、'Unchanged' 或 'Deleted' 形式返回。自上次数据字典保存以来，状态有效。如果状态为 'Deleted'，则表示的条目已从其数据字典中删除。此属性是只读的。

对象函数

deleteEntryDelete data dictionary entry
discardChangesDiscard changes to data dictionary entry
find Search in array of data dictionary entries
getValue返回数据字典条目的值
setValue设置数据字典条目的值
showChangesDisplay changes made to data dictionary entry

示例

全部折叠

使用名为 dDataSectObj 的 Simulink.data.dictionary.Section 对象表示数据字典 myDictionary_ex_API.sldd 的“设计数据”分区。

myDictionaryObj = Simulink.data.dictionary.open('myDictionary_ex_API.sldd');
dDataSectObj = getSection(myDictionaryObj,'Design Data');

在 myDictionary_ex_API.sldd 的“设计数据”分区中添加一个值为 27 的条目 myEntry。将返回的 Simulink.data.dictionary.Entry 对象赋给变量 e。

e = addEntry(dDataSectObj,'myEntry',27)
e = 

  Entry with properties:

              Name: 'myEntry'
             Value: 27
        DataSource: 'myDictionary_ex_API.sldd'
      LastModified: '2014-Aug-26 18:42:08.439709'
    LastModifiedBy: 'jsmith'
            Status: 'New'

将 myEntry 的值从 27 更改为字符向量 'My New Value'。

setValue(e,'My New Value')
e
e = 

  Entry with properties:

              Name: 'myEntry'
             Value: 'My New Value'
        DataSource: 'myDictionary_ex_API.sldd'
      LastModified: '2014-Aug-26 18:45:58.336598'
    LastModifiedBy: 'jsmith'
            Status: 'New'

使用名为 fuelFlowObj 的 Simulink.data.dictionary.Entry 对象表示数据字典条目 fuelFlow。fuelFlow 在数据字典 myDictionary_ex_API.sldd 中定义。

myDictionaryObj = Simulink.data.dictionary.open('myDictionary_ex_API.sldd');
dDataSectObj = getSection(myDictionaryObj,'Design Data');
fuelFlowObj = getEntry(dDataSectObj,'fuelFlow');

返回条目 fuelFlow 的值，并将该值赋给变量 fuelFlowValue。

fuelFlowValue = getValue(fuelFlowObj)
fuelFlowValue =

   237

使用名为 dDataSectObj 的 Simulink.data.dictionary.Section 对象表示数据字典 myDictionary_ex_API.sldd 的“设计数据”分区。myDictionary_ex_API.sldd 引用数据字典 myRefDictionary_ex_API.sldd。

myDictionaryObj = Simulink.data.dictionary.open('myDictionary_ex_API.sldd');
dDataSectObj = getSection(myDictionaryObj,'Design Data');

创建一个表示条目 fuelFlow 的 Simulink.data.dictionary.Entry 对象，该条目位于 myDictionary_ex_API.sldd 中。将对象赋给变量 e。

e = getEntry(dDataSectObj,'fuelFlow')
e = 

  Entry with properties:

              Name: 'fuelFlow'
             Value: 237
        DataSource: 'myDictionary_ex_API.sldd'
      LastModified: '2014-Sep-05 13:12:06.099278'
    LastModifiedBy: 'jsmith'
            Status: 'Unchanged'

通过修改 e 的 DataSource 属性，将条目 fuelFlow 迁移到引用数据字典 myRefDictionary_ex_API.sldd。

e.DataSource = 'myRefDictionary_ex_API.sldd'
e = 

  Entry with properties:

              Name: 'fuelFlow'
             Value: 237
        DataSource: 'myRefDictionary_ex_API.sldd'
      LastModified: '2014-Sep-05 13:12:06.099278'
    LastModifiedBy: 'jsmith'
            Status: 'Modified'

由于 myDictionary_ex_API.sldd 引用 myRefDictionary_ex_API.sldd，因此这两个字典属于同一字典层次结构，您可以在它们之间迁移条目 fuelFlow。

版本历史记录

在 R2015a 中推出

另请参阅

| | | |

主题