ReleaseCompatibilityException

升级工具箱时发生的异常

展开全部页面

描述

一个ReleaseCompatibilityException对象表示升级工具箱的个人设置时发生的异常。

创建

创建一个ReleaseCompatibilityResults对象获取特定的工具箱版本号matlab.settings.loadSettingsCompatibilityResults函数。访问PreValidationExceptions属性获取的数组ReleaseCompatibilityException对象。

例如，这段代码获取版本的预验证异常2工具箱的一部分mytoolbox作为一个数组ReleaseCompatibilityException对象。

myCompatibilityResults = matlab.settings.loadSettingsCompatibilityResults(“mytoolbox”，“Version2”）;myCompatibilityResults。PreValidationExceptions

ans = 0×0 ReleaseCompatibilityException数组，带有属性:ExceptionString ExceptionID

属性

全部展开

`ExceptionString`- - - - - -异常消息
特征向量

异常消息，指定为字符向量。如果出现异常，ExceptionString包含异常消息。

例子:“工具箱设置升级失败。无法加载“我的工具箱”工具箱的出厂更改。

`ExceptionID`- - - - - -异常标识符
字符串标量

异常标识符，指定为字符串标量。如果出现异常，ExceptionID包含异常的标识符。

例子:“MATLAB:设置:配置:FactoryTreeChangesAreEmpty”

例子

全部折叠

获得升级个人设置的结果

创建函数来创建工具箱工厂树，然后升级，然后测试升级是否成功完成。

这个函数createMyToolboxFactoryTree为工具箱创建出厂设置树mytoolbox．

函数myToolboxFactoryTree = creatatemytoolboxfactorytree ()“mytoolbox”，.．.“隐藏”、假);toolboxFontGroup = addGroup(myToolboxFactoryTree，“字体”，“隐藏”假)addSetting (toolboxFontGroup“MyFontSize”，“FactoryValue”11“隐藏”假的,.．.“ValidationFcn”@matlab.settings.mustBeNumericScalar) addSetting (toolboxFontGroup“MyFontColor”，“FactoryValue”，“黑”，.．.“隐藏”假的,“ValidationFcn”, @matlab.settings.mustBeStringScalar);结束

创建函数createMyToolboxSettingsFileUpgraders空的matlab.settings.SettingsFileUpgrader对象。

函数upgraders = createMyToolboxSettingsFileUpgraders() upgraders = matlab.settings. settingsfileupgraders .empty;结束

创建settingsInfo.json工具箱的文件。指定mytoolbox作为根设置组名，createMyToolboxFactoryTree作为设置树的创建功能，和createMyToolboxSettingsFileUpgraders作为设置树的升级功能。的地方settingsInfo.json在工具箱里资源文件夹中。

｛“ToolboxGroupName”：“mytoolbox”，“隐藏”:假的,“CreateTreeFcn”：“createMyToolboxFactoryTree”，“CreateUpgradersFcn”：“createMyToolboxSettingsFileUpgraders”｝

将包含设置树创建函数的文件夹和工具箱资源文件夹添加到MATLAB中^®路径。然后，加载出厂设置树mytoolbox．

matlab.settings.reloadFactoryFile (“mytoolbox”）;

使用设置函数访问“设置”树的根并为MyFontSize设置。

S =设置;s.mytoolbox.font.MyFontSize.PersonalValue = 15;

中的设置名称createMyToolboxFactoryTree从MyFontSize而且MyFontColor来字形大小而且FontColor．

函数myToolboxFactoryTree = creatatemytoolboxfactorytree ()“mytoolbox”，.．.“隐藏”、假);toolboxFontGroup = addGroup(myToolboxFactoryTree，“字体”，“隐藏”假)addSetting (toolboxFontGroup“字形大小”，“FactoryValue”11“隐藏”假的,.．.“ValidationFcn”@matlab.settings.mustBeNumericScalar) addSetting (toolboxFontGroup“FontColor”，“FactoryValue”，“黑”，.．.“隐藏”假的,“ValidationFcn”, @matlab.settings.mustBeStringScalar);结束

中记录两个设置的重命名createMyToolboxSettingsFileUpgraders功能作为版本的设置树的更改2的mytoolbox．当记录两个设置的重命名时，在其中一个路径中引入一个错误。例如，删除mytoolbox从第一个记录的更改的目标路径。

函数upgraders = createytoolboxsettingsfileupgraders () upgraders = matlab.settings.SettingsFileUpgrader(“Version2”）;upgraders.move (“mytoolbox.font.MyFontSize”，的字体。字形大小的）;upgraders.move (“mytoolbox.font.MyFontColor”，“mytoolbox.font.FontColor”）;结束

重新加载的出厂设置树mytoolbox．

matlab.settings.reloadFactoryFile (“mytoolbox”）;

使用设置函数访问“设置”树的根并验证字形大小设置。注意，个人价值没有被移动。

S =设置;s.mytoolbox.font.FontSize

ans =设置“mytoolbox.font”。字形大小的with properties: ActiveValue: 11 TemporaryValue:  PersonalValue:  FactoryValue: 11

获取版本的升级结果2的mytoolbox并检查第一次操作的异常日志。

upgradeResults = matlab.settings.loadSettingsCompatibilityResults(“mytoolbox”，“Version2”）;upgradeResults.Results.VersionChanges (1) .ExceptionLog

ans = ReleaseCompatibilityException with properties: ExceptionString: "工具箱设置升级失败。无法加载“我的工具箱”工具箱的出厂更改。' ExceptionID: "MATLAB:settings:config:FactoryTreeChangesAreEmpty"