ListObjects.Add 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
创建新的列表对象。 返回 对象 ListObject 。
public Microsoft.Office.Interop.Excel.ListObject Add (Microsoft.Office.Interop.Excel.XlListObjectSourceType SourceType = Microsoft.Office.Interop.Excel.XlListObjectSourceType.xlSrcRange, object Source, object LinkSource, Microsoft.Office.Interop.Excel.XlYesNoGuess XlListObjectHasHeaders = Microsoft.Office.Interop.Excel.XlYesNoGuess.xlGuess, object Destination);
Public Function Add (Optional SourceType As XlListObjectSourceType = Microsoft.Office.Interop.Excel.XlListObjectSourceType.xlSrcRange, Optional Source As Object, Optional LinkSource As Object, Optional XlListObjectHasHeaders As XlYesNoGuess = Microsoft.Office.Interop.Excel.XlYesNoGuess.xlGuess, Optional Destination As Object) As ListObject
参数
- SourceType
- XlListObjectSourceType
可选 XlListObjectSourceType。 表示查询的来源类型。 可以是以下 XlListObjectSourceType 常量之一: xlSrcExternal 或 xlSrcRange。 如果省略, SourceType
则 默认为 xlSrcRange。
- Source
- Object
当 为 xlSrcRange 时SourceType
可选。 表示 Range 数据源的 对象。 如果省略, Source
将默认为列表范围检测代码返回的范围。 当 为 xlSrcExternal 时SourceType
是必需的。 指定与源的连接的 String 值的数组。Element#Contents0URL to SharePoint 网站 1ListName 2ViewGUID
- LinkSource
- Object
可选属性,类型为 Boolean。 表示外部数据源是否链接到 ListObject 对象。 如果 SourceType
为 xlSrcExternal,则默认值为 True。 如果 SourceType
为 xlSrcRange,则无效,如果未省略,将返回错误。
- XlListObjectHasHeaders
- XlYesNoGuess
可选 对象。 一个 XlYesNoGuess 常量,指示导入的数据是否具有列标签。 如果 Source 没有标题,Excel 将自动生成标题。
- Destination
- Object
可选 对象。 一个 Range 对象,作用是将一个单元格引用指定为新列表对象左上角的目标区域。 如果 Range 对象引用多个单元格,则会生成错误。
Destination
当 设置为 xlSrcExternal 时SourceType
,必须指定参数。
Destination
如果 SourceType
设置为 xlSrcRange,则忽略参数。 目标区域必须位于包含指定 ListObjects 集合的工作表上。 新列将插入 到 以适应 Destination
新列表。 因此,现有数据不会被覆盖。
返回
注解
当列表有标题时,第一行单元格将转换为 Text(如果还未被设为文本)。 转换将基于单元格的可见文本。 这意味着,如果有一个日期值,该日期值的 Date 格式随区域设置的更改而更改,则对列表的转换可能产生不同的结果,具体取决于当前的系统区域设置。 而且,如果标题行中有两个单元格包含相同的可见文本,则会追加递增的 Integer 以使每个列标题唯一。