WPS 基础接口 > 表格 API 参考 > QueryTable > QueryTable 对象成员

代表一个利用从外部数据源（如 SQL Server 或 Microsoft Access 数据库）返回的数据生成的工作表表格。

方法

?名称说明
CancelRefresh取消指定查询表的所有后台查询。使用 Refreshing 属性可以确定当前是否正在进行后台查询。
Delete删除对象。
Refresh更新外部数据区域 (QueryTable)。
ResetTimer重新设置指定的查询表或数据透视表的刷新计时器，使其时间间隔等于上次使用 RefreshPeriod 属性设置的时间间隔。
SaveAsODC将查询表缓存的源保存为“Microsoft Office 数据连接”文件。

属性

?名称说明
AdjustColumnWidth 如果每次刷新指定的查询表时列宽都会自动调整为最适合的宽度，则为 True。如果每次刷新时列宽不进行自动调整，则为 False。默认值为 True。Boolean 类型，可读写。
Application如果不使用对象识别符，则该属性返回一个代表 ET 应用程序的 Application 对象。如果使用对象识别符，则该属性返回一个代表指定对象的创建程序的 Application 对象（可对一个 OLE 自动化对象使用该属性来返回该对象的应用程序）。只读。
BackgroundQuery 如果查询表的查询是异步执行（在后台执行）的，则为 True。Boolean 类型，可读写。
CommandText返回或设置指定数据源的命令串。Variant 型，可读写。
CommandType返回或设置备注部分的下表中列出的 XlCmdType 常量之一。返回或设置的常量用于描述 CommandText 属性的值。默认值为 xlCmdSQL。XlCmdType 类型，可读写。
Connection返回或设置包含下列某项的字符串：允许 ET 连接到 OLE DB 数据源的 OLE DB 设置；允许 ET 连接到 ODBC 数据源的 ODBC 设置；允许 ET 连接到 Web 数据源的 URL；或者文本文件的名称或路径，或是指定某个数据库或 Web 查询的文件名称或路径。Variant 型，可读写。
Creator返回一个 32 位整数，该整数指示创建对象的应用程序。只读 Long 类型。
Destination返回查询表目标区域（查询结果表放置的区域）的左上角单元格。目标区域必须位于包含 QueryTable 对象的工作表中。只读 Range。
EditWebPage返回或设置用于 Web 查询的网页的统一资源定位符 (URL)。Variant 类型，可读写。
EnableEditing如果允许用户对指定查询表进行编辑，则该值为 True；如果用户只能刷新查询表，则该值为 False。Boolean 类型，可读写。
EnableRefresh 如果用户可刷新数据透视表高速缓存或查询表，则为 True。默认值为 True。Boolean 类型，可读写。
FetchedRowOverflow如果上次使用 Refresh 方法返回的行数比工作表中可用行数大，则该值为 True。Boolean 类型，只读。
FieldNames如果数据源的字段名称作为返回数据的列标题显示，则该值为 True。默认值为 True。Boolean 类型，可读写。
FillAdjacentFormulas如果每当查询表刷新时，指定查询表右侧的公式就自动更新，则该属性值为 True。Boolean 类型，可读写。
ListObject返回 QueryTable 对象的 ListObject 对象。只读 ListObject 对象。
MaintainConnection 如果从刷新数据开始直至关闭工作簿，都一直保留指向指定数据源的连接，则为 True。默认值是 True。Boolean 类型，可读写。
Name返回或设置一个 String 值，它代表对象的名称。
Parameters返回一个 Parameters 集合，该集合代表查询表参数。只读。
Parent返回指定对象的父对象。只读。
PostText返回或设置用于 post 方法的字符串，post 方法用于向 Web 服务器输入数据以从 Web 查询中返回数据。String 类型，可读写。
PreserveColumnInfo如果每次刷新查询表时，列排序、筛选和布局信息都会保留，则该值为 True。默认值为 False。Boolean 类型，可读写。
PreserveFormatting 如果将数据前五行的任何常用格式设置应用到查询表的新数据行，则为 True。对未使用的单元格不进行格式设置。如果将应用到查询表的最新一次自动套用格式应用于新数据行，则属性为 False。默认值是 True。
QueryType表示 ET 填充查询表时所使用的查询类型。XlQueryType 类型，只读。
Recordset返回或设置一个 Recordset 对象，该对象用作指定查询表的数据源。
Refreshing 如果指定的查询表正在进行后台查询，则为 True。可读/写 Boolean 类型。
RefreshOnFileOpen 如果每次打开工作簿时，数据透视表高速缓存或查询表自动更新，则为 True。默认值为 False。Boolean 类型，可读写。
RefreshPeriod返回或设置两次刷新之间的时间间隔。Long 型，可读写。
RefreshStyle返回或设置为了容纳查询返回的记录集中的行数而在指定工作表中插入或删除行时所使用的方式。XlCellInsertionMode 类型。可读写。
ResultRange返回一个 Range 对象，该对象代表指定查询表所覆盖的工作表区域。只读。
RobustConnect返回或设置数据透视表缓存与其数据源连接的方式。XlRobustConnect 类型，可读写。
RowNumbers如果行号作为第一列添加到指定查询表，则该属性值为 True。Boolean 类型，可读写。
SaveData 如果将数据透视表的数据随工作簿一起保存，则为 True。如果仅保存数据透视表的定义，则为 False。Boolean 类型，可读写。
SavePassword 如果将 ODBC 连接字符串中的密码信息与指定查询一起保存，则为 True。如果不保存密码信息，则该值为 False。Boolean 类型，可读写。
Sort返回查询表范围的排序条件。只读。
SourceConnectionFile返回或设置一个 String 值，它指明用于创建查询表的 Microsoft Office 数据连接文件或类似文件。可读写。
SourceDataFile返回或设置一个 String 值，它指明查询表的源数据文件。
TextFileColumnDataTypes返回或设置一个有序的常量数组，用于指定文本文件中相应列的数据类型，而该文本文件则是正要导入查询表中的文本文件。每一列的默认常量为 xlGeneral。Variant 类型，可读写。
TextFileCommaDelimiter如果将文本文件导入查询表中时，以逗号作为分隔符，则该值为 True。如果以其他字符作为分隔符，则该值为 False。默认值为 False。Boolean 类型，可读写。
TextFileConsecutiveDelimiter当向查询表中导入文本文件时，如果将连续分隔符看作是一个分隔符，则该值为 True。默认值为 False。Boolean 类型，可读写。
TextFileDecimalSeparator返回或设置小数分隔符，在将文本文件导入查询表中时，ET 将使用小数分隔符。默认值为系统小数分隔符。String 类型，可读写。
TextFileFixedColumnWidths返回或设置一个整数数组，该数组对应于正要向查询表中导入的文本文件的列宽（按字符）。有效的宽度为 1 到 32767 个字符。Variant 类型，可读写。
TextFileOtherDelimiter返回或设置在向查询表中导入文本文件时用作分隔符的字符。默认值为 null。String 类型，可读写。
TextFileParseType返回或设置要导入查询表的文本文件中数据的列格式。XlTextParsingType 类型，可读写。
TextFilePlatform返回或设置正向查询表中导入的文本文件的原始格式。该属性确定在数据导入过程中使用何种代码页。XlPlatform 类型，可读写。
TextFilePromptOnRefresh如果每次刷新查询表时都要指定导入文本文件的名称，则该属性值为 True。“导入文本文件”对话框允许用户指定路径和文件名。默认值为 False。Boolean 类型，可读写。
TextFileSemicolonDelimiter如果在将文本文件导入查询表时使用分号作为分隔符，并且 TextFileParseType 属性的值为 xlDelimited，则为 True。默认值为 False。Boolean 类型，可读写。
TextFileSpaceDelimiter如果向查询表中导入文本文件时，使用空格字符作为分隔符，则该值为 True。默认值为 False。Boolean 类型，可读写。
TextFileStartRow返回或设置向查询表中导入文本文件时进行文本分列的起始行号。其有效值为 1 到 32767 之间的整数。默认值为 1。Long 类型，可读写。
TextFileTabDelimiter如果向查询表中导入文本文件时使用 Tab 作为分隔符，则该值为 True。默认值为 False。Boolean 类型，可读写。
TextFileTextQualifier返回或设置向查询表中导入文本文件时的文本识别符。文本识别符用于指定包含的数据是文本格式。XlTextQualifier 类型，可读写。
TextFileThousandsSeparator返回或设置向查询表中导入文本文件时 ET 所使用的千位分隔符。默认为系统千位分隔符。String 类型，可读写。
TextFileTrailingMinusNumbers如果为 True，则表示 ET 将导入的数字作为以“-”符号开头的文本，“-”符号为负号。如果为 False，则表示 ET 将导入的数字作为以“-”符号开头的文本，“-”符号为文本。Boolean 类型，可读写。
TextFileVisualLayout返回或设置一个 XlTextVisualLayoutType 枚举，该枚举指示要导入的文本的可见布局是从左到右还是从右到左。
WebConsecutiveDelimitersAsOne当从网页的 HTML <PRE> 标记中向查询表导入数据时，如果将连续多个分隔符看作单个分隔符，并且数据将被分列，则该值为 True。如果将连续多个分隔符看作多个分隔符，则该值为 False。默认值是 True。可读/写 Boolean 类型。
WebDisableDateRecognition向查询表中导入网页时，如果将类似日期的数据当作文本进行处理，则该值为 True。如果使用了日期识别，则该值为 False。默认值为 False。Boolean 类型，可读写。
WebDisableRedirections如果对 QueryTable 对象禁用 Web 查询重定向，则该属性的值为 True。默认值为 False。Boolean 类型，可读写。
WebFormatting返回或设置一个值，该值确定向查询表中导入网页时网页中应用了多少格式设置（如果有）。XlWebFormatting 类型，可读写。
WebPreFormattedTextToColumns返回或设置向查询表中导入网页时，是否对网页 HTML <PRE> 标记内的数据进行分列。默认值为 True。Boolean 类型，可读写。
WebSelectionType返回或设置一个值，该值决定是向查询表中导入整个网页、网页上的所有表格还是仅网页上的特定表格。XlWebSelectionType 类型，可读写。
WebSingleBlockTextImport向查询表中导入网页时，如果位于指定网页的 HTML <PRE> 标记中的数据是同时进行处理的，则该值为 True。如果数据是以连续行的数据块方式导入的，以便能识别标题行，则该值为 False。默认值为 False。Boolean 类型，可读写。
WebTables向查询表中导入网页时，返回或设置由逗号分隔的表格名称或表格索引号的列表。String 类型，可读写。
WorkbookConnection返回查询表使用的 WorkbookConnection 对象。只读。

事件

?名称说明
AfterRefresh当完成或者取消一个查询时，发生此事件。
BeforeRefresh在刷新查询表之前产生此事件。这里的刷新包括调用 Refresh 方法引起的变化，用户的操作引起的变化和打开包含该查询表的工作簿引起的变化。