Main Content

本页采用了机器翻译。点击此处可查看英文原文。

addExcelSpecification

将 Microsoft Excel 表添加到基线准则或测试用例输入

全页折叠

语法

addExcelSpecification(obj,'Sheet',sheet)
addExcelSpecification(obj,'Sheet',sheet,'Range',range)

说明

addExcelSpecification(obj,'Sheet',sheet) 将指定的 Excel® 表添加到基线准则或测试用例输入 obj。

示例

addExcelSpecification(obj,'Sheet',sheet,'Range',range) 将指定范围内的单元格添加到基线准则或测试用例输入。

示例

全部折叠

创建测试文件、测试套件和测试用例结构体。

tf = sltest.testmanager.TestFile('Add Excel Test');
ts = createTestSuite(tf,'Add Excel Suite');
tc = createTestCase(ts,'baseline','Baseline Excel Test Case');

从 Excel 文件添加基线准则。指定两张工作表会创建两个基线准则。

base = addBaselineCriteria(tc,'C:\MATLAB\baseline.xlsx','Sheets',{'Optics','Converter'});

将工作表 X2Out 添加到第一组。

base(1).addExcelSpecification('Sheet','X2Out');

显示每个基线准则的 Excel 规范的 Sheet 属性的内容。第一组现在包括 X2Out 表。

base(1).ExcelSpecifications(:).Sheet
base(2).ExcelSpecifications(:).Sheet
ans =
    'Optics'

ans =
    'X2Out'

ans =
    'Converter'

输入参数

全部折叠

要添加 Excel 工作表或单元格数据的对象，指定为基线准则或测试用例输入对象。

Excel 表添加到基线准则或测试用例输入，指定为字符向量。

示例: 'Optics'

要添加到测试用例输入的指定工作表中的单元格范围，指定为以下形式之一的字符向量或字符串：

指定 Range 的方法 描述

'Corner1:Corner2'

矩形范围

使用语法 'Corner1:Corner2' 指定范围，其中 Corner1 和 Corner2 是定义区域的两个相对的角。例如，'D2:H4' 表示工作表上两个角 D2 和 H4 之间的 3×5 矩形区域。'Range' 名称-值对参量不区分大小写，并使用 Excel A1 引用样式（参见 Excel 帮助）。

示例： 'Range','Corner1:Corner2'

''

未指定或为空

如果未指定，导入功能会自动检测使用的范围。

示例： 'Range',''

注意：使用范围是指电子表格中实际包含数据的矩形部分。导入功能通过修剪不包含数据的前导行和尾随行和列来自动检测使用的范围。仅由空白组成的文本被视为数据，并在使用范围内捕获。

'Row1:Row2'

行范围

您可以通过使用 Excel 行指示符指定开始行和结束行来识别范围。然后 readtable 会自动检测指定行内使用的列范围。例如，导入函数将范围规范 '1:7' 解释为读取第 1 行到第 7 行（包括）中使用的范围中的列的指令。

示例： 'Range','1:7'

'Column1:Column2'

列范围

您可以通过使用 Excel 列指示符指定开始列和结束列来识别范围。然后 readtable 会自动检测指定列中使用的行范围。例如，导入函数将范围规范 'A:F' 解释为读取 A 列到 F 列（包括）中所用范围内的行的指令。

示例： 'Range','A:F'

'NamedRange'

Excel 命名范围

在 Excel 中，您可以创建名称来标识电子表格中的范围。例如，您可以选择电子表格的矩形部分并将其命名为 'myTable'。如果电子表格中存在这样的命名范围，则导入函数可以使用其名称读取该范围。

示例： 'Range','myTable'

示例: 'A1:C20'

版本历史记录

在 R2017b 中推出

另请参阅

|

主题