QueryTable 接口
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示从外部数据源（如 SQL Server 或 Microsoft Access 数据库）返回的数据生成的工作表表。 QueryTable 对象是 集合的成员QueryTables。
public interface class QueryTable : Microsoft::Office::Interop::Excel::_QueryTable, Microsoft::Office::Interop::Excel::RefreshEvents_Event[System.Runtime.InteropServices.Guid("00024428-0000-0000-C000-000000000046")]
public interface QueryTable : Microsoft.Office.Interop.Excel._QueryTable, Microsoft.Office.Interop.Excel.RefreshEvents_EventPublic Interface QueryTable
Implements _QueryTable, RefreshEvents_Event- 派生
- 属性
- 实现
注解
这是派生自 COM Coclass（托管代码要求此 Coclass 来实现与相应的 COM 对象的互操作性）的 .NET 接口。 使用此派生的接口来访问所有方法、属性和 COM 对象的事件成员。 但是，如果您想要使用的方法或事件共享同一名称并且位于相同的 COM 对象下，请转换为相应的主接口以调用该方法，并转换为最新的事件接口以连接到该事件。 参考此主题以获取有关 COM 对象的信息。 有关 COM 对象的方法和属性成员的信息，请参阅 _QueryTable。
使用 QueryTables (index) （其中 index 是查询表的索引号）返回单个 QueryTable 对象。
属性
| AdjustColumnWidth |
如果在每次刷新指定的查询表或 XML 映射时自动调整列宽以获得最佳拟合度，则为 True。 如果每次刷新时列宽不自动调整，则为 False。 默认值为 True。 读/写 Boolean。 (继承自 _QueryTable) |
| Application |
返回一个 Application 对象，该对象代表 Microsoft Excel 应用程序。 此为只读属性。 (继承自 _QueryTable) |
| BackgroundQuery |
如此 如果 对数据透视表或查询表的查询在后台) 异步执行 (。 读/写 Boolean。 (继承自 _QueryTable) |
| CommandText |
返回或设置指定数据源的命令字符串。 读取/写入 对象 。 (继承自 _QueryTable) |
| CommandType |
返回或设置一个 XlCmdType 常量，该常量描述与 属性关联的 CommandText 命令类型。 默认值为 xlCmdSQL。 读/写 XlCmdType。 (继承自 _QueryTable) |
| Connection |
返回或设置一个字符串，其中包含查询表的连接信息。 读取/写入 对象 。 (继承自 _QueryTable) |
| Creator |
在枚举中 XlCreator 返回一个常量，该常量指示创建此对象的应用程序。 如果该对象是在 Microsoft Excel 中创建的，则此属性返回字符串 XCEL，它等同于十六进制的数字 5843454C。 只读 XlCreator。 (继承自 _QueryTable) |
| Destination |
返回查询表目标区域（查询结果表放置的区域）的左上角单元格。 目标区域必须位于包含 对象的 QueryTable 工作表上。 只读 区域 。 (继承自 _QueryTable) |
| EditWebPage |
返回或设置网页查询的统一资源定位符 (URL) 。 读取/写入 对象 。 (继承自 _QueryTable) |
| EnableEditing |
如果用户可以编辑指定的查询表，则为 True。 如果用户只能刷新查询表，则为 False。 读/写 Boolean。 (继承自 _QueryTable) |
| EnableRefresh |
如果用户可刷新数据透视表高速缓存或查询表，则为 True。 默认值为 True。 读/写 Boolean。 (继承自 _QueryTable) |
| FetchedRowOverflow |
如果上次使用 方法返回的Refresh(Object)行数大于工作表上可用的行数，则为 True。 只读 Boolean。 (继承自 _QueryTable) |
| FieldNames |
如果数据源的字段名称作为返回数据的列标题显示，则该值为 True。 默认值为 True。 读/写 Boolean。 (继承自 _QueryTable) |
| FillAdjacentFormulas |
如果每当查询表刷新时，指定查询表右侧的公式就自动更新，则该属性值为 True。 读/写 Boolean。 (继承自 _QueryTable) |
| HasAutoFormat |
仅供内部使用。 (继承自 _QueryTable) |
| ListObject |
返回 ListObject 对象 Range 或 QueryTable 对象的 对象。 ListObject 对象类型，只读。 (继承自 _QueryTable) |
| MaintainConnection |
如果从刷新数据开始直至关闭工作簿，都一直保留指向指定数据源的连接，则为 True。 默认值为 True。 读/写 Boolean。 (继承自 _QueryTable) |
| Name |
返回或设置对象的名称。 读/写 String。 (继承自 _QueryTable) |
| Parameters |
返回表示 Parameters 查询表参数的集合。 此为只读属性。 (继承自 _QueryTable) |
| Parent |
返回指定对象的父对象。 只读。 (继承自 _QueryTable) |
| PostText |
返回或设置用于 post 方法的字符串，post 方法用于向 Web 服务器输入数据以从 Web 查询中返回数据。 读/写 String。 (继承自 _QueryTable) |
| PreserveColumnInfo |
如果每次刷新查询表时，列排序、筛选和布局信息都会保留，则该值为 True。 默认值为 False。 读/写 Boolean。 (继承自 _QueryTable) |
| PreserveFormatting |
如果将前五行数据共有的任何格式应用于查询表中的新数据行，则此属性为 True 。 对未使用的单元格不进行格式设置。 如果将应用到查询表的最新一次自动套用格式应用于新数据行，则属性为 False。 默认值为 True (除非查询表是在 Microsoft Excel 97 中创建的，并且 HasAutoFormat 属性为 True，在这种情况下 ，PreserveFormatting 为 False) 。 读/写 Boolean。 (继承自 _QueryTable) |
| QueryType |
指示 Microsoft Excel 用于填充查询表或数据透视表缓存的查询类型。 只读 XlQueryType。 (继承自 _QueryTable) |
| Recordset |
返回或设置一个 Recordset 对象，该对象用作指定查询表或数据透视表缓存的数据源。 读/写。 (继承自 _QueryTable) |
| Refreshing |
如果指定的查询表正在进行后台查询，则为 True。 读/写 Boolean。 (继承自 _QueryTable) |
| RefreshOnFileOpen |
如果每次打开工作簿时，数据透视表高速缓存或查询表自动更新，则为 True。 默认值为 False。 读/写 Boolean。 (继承自 _QueryTable) |
| RefreshPeriod |
返回或设置两次刷新之间的时间间隔。 Integer 型，可读/写。 (继承自 _QueryTable) |
| RefreshStyle |
返回或设置指定工作表上的行的添加或删除方式，以容纳查询返回的记录集中的行数。 读/写 XlCellInsertionMode。 (继承自 _QueryTable) |
| ResultRange |
返回一个 Range 对象，该对象表示指定查询表占用的工作表区域。 此为只读属性。 (继承自 _QueryTable) |
| RobustConnect |
返回或设置数据透视表缓存与其数据源连接的方式。 读/写 XlRobustConnect。 (继承自 _QueryTable) |
| RowNumbers |
如果行号作为第一列添加到指定查询表，则该属性值为 True。 读/写 Boolean。 (继承自 _QueryTable) |
| SaveData |
如果数据透视表的数据随工作簿一起保存，则为 True。 如果仅保存数据透视表的定义，则为 False。 读/写 Boolean。 (继承自 _QueryTable) |
| SavePassword |
如果将 ODBC 连接字符串中的密码信息与指定查询一起保存，则为 True。 如果删除密码，则为 False。 读/写 Boolean。 (继承自 _QueryTable) |
| Sort |
返回查询表范围的排序条件。 此为只读属性。 (继承自 _QueryTable) |
| SourceConnectionFile |
返回或设置一个 String，它指明用于创建数据透视表的 Microsoft Office 数据连接文件或类似的文件。 读/写。 (继承自 _QueryTable) |
| SourceDataFile |
返回或设置一个 String 类型的值，指示查询表的源数据文件。 (继承自 _QueryTable) |
| Sql |
仅供内部使用。 (继承自 _QueryTable) |
| TablesOnlyFromHTML |
依据输入值和工作表上定义的公式创建模拟运算表。 (继承自 _QueryTable) |
| TextFileColumnDataTypes |
返回或设置一个有序的常量数组，用于指定文本文件中相应列的数据类型，而该文本文件则是正要导入查询表中的文本文件。 每一列的默认常量为 xlGeneral。 读取/写入 对象 。 (继承自 _QueryTable) |
| TextFileCommaDelimiter |
如果将文本文件导入查询表中时，以逗号作为分隔符，则该值为 True。 如果以其他字符作为分隔符，则该值为 False。 默认值为 False。 读/写 Boolean。 (继承自 _QueryTable) |
| TextFileConsecutiveDelimiter |
当向查询表中导入文本文件时，如果将连续分隔符看作是一个分隔符，则该值为 True。 默认值为 False。 读/写 Boolean。 (继承自 _QueryTable) |
| TextFileDecimalSeparator |
返回或设置小数分隔符，在将文本文件导入查询表中时，Microsoft Excel 将使用小数分隔符。 默认值为系统小数分隔符。 读/写 String。 (继承自 _QueryTable) |
| TextFileFixedColumnWidths |
返回或设置一个整数数组，该数组对应于正要向查询表中导入的文本文件的列宽（按字符）。 有效宽度为 1 到 32,767 个字符。 读取/写入 对象 。 (继承自 _QueryTable) |
| TextFileOtherDelimiter |
返回或设置在向查询表中导入文本文件时用作分隔符的字符。 默认值为 Null。 读/写 String。 (继承自 _QueryTable) |
| TextFileParseType |
返回或设置要导入查询表的文本文件中数据的列格式。 读/写 XlTextParsingType。 (继承自 _QueryTable) |
| TextFilePlatform |
返回或设置正向查询表中导入的文本文件的原始格式。 该属性确定在数据导入过程中使用何种代码页。 默认值是在“文本文件导入向导”的“文件原始格式”选项中的当前设置。 读/写 XlPlatform。 (继承自 _QueryTable) |
| TextFilePromptOnRefresh |
如果每次刷新查询表时都要指定导入文本文件的名称，则该属性值为 True。 “导入文本文件”对话框允许用户指定路径和文件名。 默认值为 False。 读/写 Boolean。 (继承自 _QueryTable) |
| TextFileSemicolonDelimiter |
如果在将文本文件导入查询表中时分号为分隔符，并且属性的值为 xlDelimited，则该属性值TextFileParseType为 True。 默认值为 False。 读/写 Boolean。 (继承自 _QueryTable) |
| TextFileSpaceDelimiter |
如果向查询表中导入文本文件时，使用空格字符作为分隔符，则该值为 True。 默认值为 False。 读/写 Boolean。 (继承自 _QueryTable) |
| TextFileStartRow |
返回或设置向查询表中导入文本文件时进行文本分列的起始行号。 有效值为 1 到 32,767 的整数。 默认值为 1。 Integer 型，可读/写。 (继承自 _QueryTable) |
| TextFileTabDelimiter |
如果向查询表中导入文本文件时使用 Tab 作为分隔符，则该值为 True。 默认值为 False。 读/写 Boolean。 (继承自 _QueryTable) |
| TextFileTextQualifier |
返回或设置向查询表中导入文本文件时的文本识别符。 文本识别符用于指定包含的数据是文本格式。 读/写 XlTextQualifier。 (继承自 _QueryTable) |
| TextFileThousandsSeparator |
返回或设置 Microsoft Excel 在将文本文件导入查询表中时使用的千位分隔符。 默认为系统千位分隔符。 读/写 String。 (继承自 _QueryTable) |
| TextFileTrailingMinusNumbers |
如此 对于 Microsoft Excel，将导入的数字视为以“-”符号开头的文本作为负数。 如果为 False，则表示 Excel 将导入的数字作为以“-”符号开头的文本，“-”符号为文本。 读/写 Boolean。 (继承自 _QueryTable) |
| TextFileVisualLayout |
返回或设置一个 XlTextVisualLayoutType 常量，该常量指示导入的文本的视觉布局是从左到右还是从右到左。 (继承自 _QueryTable) |
| WebConsecutiveDelimitersAsOne |
如此 如果在 将数据从网页中的 HTML <PRE> 标记导入查询表中，以及将数据分析为列时，连续分隔符被视为单个分隔符。 如果将连续多个分隔符看作多个分隔符，则该值为 False。 默认值为 True。 读/写 Boolean。 (继承自 _QueryTable) |
| WebDisableDateRecognition |
向查询表中导入网页时，如果将类似日期的数据当作文本进行处理，则该值为 True。 如果使用了日期识别，则该值为 False。 默认值为 False。 读/写 Boolean。 (继承自 _QueryTable) |
| WebDisableRedirections |
如果为 对象禁用 Web 查询重定向，则为 QueryTableTrue。 默认值为 False。 读/写 Boolean。 (继承自 _QueryTable) |
| WebFormatting |
返回或设置一个值，该值确定向查询表中导入网页时网页中应用了多少格式设置（如果有）。 读/写 XlWebFormatting。 (继承自 _QueryTable) |
| WebPreFormattedTextToColumns |
返回或设置在将网页导入查询表中时，网页中 HTML <PRE> 标记中包含的数据是否分析为列。 默认值为 True 。 读/写 Boolean。 (继承自 _QueryTable) |
| WebSelectionType |
返回或设置一个值，该值决定是向查询表中导入整个网页、网页上的所有表格还是仅网页上的特定表格。 读/写 XlWebSelectionType。 (继承自 _QueryTable) |
| WebSingleBlockTextImport |
如果在将页面导入查询表中时，一次性处理指定网页中 HTML <PRE> 标记中的数据，则为 True。 如果数据是以连续行的数据块方式导入的，以便能识别标题行，则该值为 False。 默认值为 False。 读/写 Boolean。 (继承自 _QueryTable) |
| WebTables |
向查询表中导入网页时，返回或设置由逗号分隔的表格名称或表格索引号的列表。 读/写 String。 (继承自 _QueryTable) |
| WorkbookConnection |
返回 WorkbookConnection 查询表使用的 对象。 此为只读属性。 (继承自 _QueryTable) |
方法
| CancelRefresh() |
取消指定查询表的所有后台查询。 Refreshing使用 属性可以确定后台查询当前是否正在进行中。 (继承自 _QueryTable) |
| Delete() |
删除对象。 (继承自 _QueryTable) |
| Refresh(Object) |
汇报外部数据范围 (QueryTable) 。 Boolean 类型的值 。 (继承自 _QueryTable) |
| ResetTimer() |
将指定查询表或数据透视表的刷新计时器重置为使用 RefreshPeriod 属性设置的最后一个间隔。 (继承自 _QueryTable) |
| SaveAsODC(String, Object, Object) |
将数据透视表缓存源保存为 Microsoft Office 数据连接文件。 (继承自 _QueryTable) |
事件
| AfterRefresh |
当完成或者取消一个查询时，发生此事件。 (继承自 RefreshEvents_Event) |
| BeforeRefresh |
在刷新查询表之前产生此事件。 这里的刷新包括调用 Refresh 方法引起的变化，用户的操作引起的变化和打开包含该查询表的工作簿引起的变化。 (继承自 RefreshEvents_Event) |