读取范围
<h1>功能</h1>
<p>1、将电子表格中以’范围Excel格式’存在的范围值读取为数据表。如果未指定范围，则读取整个电子表格。
2、如果将范围指定为一个单元格，则从该单元格开始读取整个电子表格。</p>
<h1><strong>输入</strong></h1>
<table>
<thead>
<tr>
<th>名称</th>
<th>说明</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>范围</td>
<td>【字符串】指定待读取的单元格范围。如果未指定该值，则读取整个电子表格。如果该值只包含一个单元格，则从该单元格开始读取。</td>
<td>'A1:C3'</td>
</tr>
<tr>
<td>方向</td>
<td>【枚举】指定移动方向。</td>
<td>Down</td>
</tr>
<tr>
<td>工作表名称</td>
<td>【字符串】工作簿中的工作表名称。</td>
<td>‘sheet1’</td>
</tr>
</tbody>
</table>
<h1><strong>选项</strong></h1>
<table>
<thead>
<tr>
<th>名称</th>
<th>说明</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>添加表头</td>
<td>【布尔】选中后，还将提取指定电子表格范围内的列标题。默认情况下，此复选框处于选中状态（设置为True）</td>
<td>是</td>
</tr>
<tr>
<td>使用筛选器</td>
<td>【布尔】选择后，活动将不会读取已过滤超出指定范围的内容。默认情况下，未选中此复选框，因此将读取整个范围，而不管是否已滤除某些信息。</td>
<td>否</td>
</tr>
</tbody>
</table>
<h1><strong>输出</strong></h1>
<table>
<thead>
<tr>
<th>名称</th>
<th>说明</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>数据表</td>
<td>【数据表】输出存储了已读数据的数据表对象</td>
<td>Table1</td>
</tr>
</tbody>
</table>
<h1><strong>注意/说明</strong></h1>
<p>1、表格的列表头不能重复，否则会报错。
2、方向，仅当范围选择为单元格时有效。例如方向空，则仅选取一个单元格。
3.如果范围为空，则读取时将不受读取的方向控制，读取的是整个表格。
4.如果范围只包含一个单元格，则读取范围将受到读取方向的限制，如下：
（1）方向选择为“空”：则只读取该单元格。
（2）方向选择“Down”：则读取的是从该单元格开始，且是该单元格所在的列的范围内容。
（3）方向选择“ToRight”：则读取的是从该单元格开始，且是该单元格所在的行的范围内容。</p>
<h1>相关函数</h1>
<p>无</p>
<h1><strong>示例/演示</strong></h1>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/e56557cf2ea87df98fd924ad0cd6e38b" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/e2ff28939aee44b10a7b9200c1460903" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/8e3a6bfae950df911e51f4888749e6df" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/7fa3289cc9aafa13f18588a54e0507a8" alt="" /></p>
<h1>示例附件</h1>
<p><a href="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/626812288e69f858344010a63e1a861f" title="[组件[读取范围]_20210208.db">组件[读取范围]_20210208.db</a></p>