ListObject 接口

  • 参考

定义

命名空间:
Microsoft.Office.Tools.Excel
程序集:
Microsoft.Office.Tools.Excel.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

ListObject 控件在一系列行和列中显示数据。

[System.Runtime.InteropServices.Guid("48eb309a-698d-4d40-95af-d9d083e63d30")]
public interface ListObject : IDisposable, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent
属性
GuidAttribute
实现
IComponent ISupportInitialize IDisposable IBindableComponent

注解

有关更多信息，请参见 ListObject Control。

备注

此接口由 Visual Studio Tools for Office Runtime 实现。 不应在代码中实现此接口。 有关更多信息，请参见 Visual Studio Tools for Office Runtime Overview。

用法

本文档介绍面向 .NET Framework 4 或更高版本的 Office 项目中所用的此类型的版本。 在面向 .NET Framework 3.5 的项目中，此类型可能具有不同的成员，因此本文档为此类型提供的代码示例可能并不适用。 有关在面向 .NET Framework 3.5 的项目中使用此类型的文档，请参阅 Visual Studio 2008 文档中的以下参考部分：http://go.microsoft.com/fwlink/?LinkId=160658。

属性

Active

获取一个值，该值指示工作表上的 ListObject 控件是否处于活动状态；即，活动单元格是否位于 ListObject 控件的范围内。
AlternativeText

获取或设置指定表的说明性（可选）文本字符串。
Application

获取一个表示 Microsoft Office Excel 应用程序或 Application 创建者的 ListObject。
AutoFilter

获取一个筛选的表。
AutoSelectRows

获取或设置一个值，该值指示在 SelectedIndex 发生更改时是否选择整行。
AutoSetDataBoundColumnHeaders

获取或设置一个值，该值确定是否自动将列标题设置为与数据源相匹配。
Comment

获取或设置与 ListObject 关联的注释。
Container
Creator

获取在其中创建 ListObject 的应用程序。
DataBodyRange

获取一个 Range，它表示包含标题行和插入行之间列表中数据区域的范围。
DataBoundFormat

获取或设置数据绑定 ListObject 控件的格式样式。
DataBoundFormatSettings

获取或设置要向 FormatSettings 控件应用指定 XlRangeAutoFormat 的哪个 ListObject。
DataMember

获取或设置多成员数据源中要绑定到 ListObject 控件的特定数据成员。
DataSource

获取或设置包含用于填充该控件中的项的值列表的源。
DefaultDataSourceUpdateMode

获取或设置默认 DataSourceUpdateMode。
DisplayName

获取或设置显示名称。
DisplayRightToLeft

获取一个值，该值指示 ListObject 是否从右向左（而非从左向右）显示。
HeaderRowRange

获取一个表示标题行范围的 Range。
InnerObject

获取一个 ListObject，表示 ListObject 的基础本机对象。
InsertRowRange

获取一个表示 Range 控件的插入行（如果有的话）的 ListObject。
IsBinding

获取一个值，该值指示数据绑定功能是否处于活动状态。
IsSelected

获取一个值，该值指示 ListObject 是否处于选定状态。
ListColumns

获取一个 ListColumns 集合，该集合表示 ListObject 控件中的所有列。
ListRows

获取一个 ListRows 对象，该对象表示 ListObject 控件中的所有数据行。
MappedColumns
Name

获取或设置 ListObject 控件的名称。
Parent

获取 ListObject 控件的父对象。
QueryTable

获取 QueryTable，它为 ListObject 控件提供指向列表服务器的链接。
Range

获取一个 Range，表示要应用 ListObject 的范围。
SaveSortOrder

获取或设置一个值，该值指示 ListObject 控件的行顺序是否已保存到工作表中。
SelectedIndex

获取或设置当前选定的行的索引。
SharePointURL

获取给定 ListObject 控件的 SharePoint 列表的 URL。
ShowAutoFilter

获取或设置一个值，该值指示是否显示自动筛选。
ShowHeaders

获取或设置一个值，该值指示是否应显示标题信息。
ShowTableStyleColumnStripes

设置或获取一个值，该值指示是否使用列条纹表样式。
ShowTableStyleFirstColumn

获取或设置一个值，该值指示是否对第一列设置格式。
ShowTableStyleLastColumn

获取或设置一个值，该值指示是否对最后一列设置格式。
ShowTableStyleRowStripes

设置或获取一个值，该值指示是否使用行条纹表样式。
ShowTotals

获取或设置一个值，该值表示总计行是否可见。
Sort

获取 ListObject 集合的一个或多个排序列以及排序顺序。
SourceType

获取列表的当前源。
Summary

获取或设置与指定表的可选文本字符串关联的说明。
TableStyle

获取或设置表样式。
Tag

获取或设置包含有关 Tag 控件的数据的对象。
TotalsRowRange

获取一个表示 Range 控件的总计行的 ListObject。
XmlMap

获取一个表示该列表所用架构映射的 XmlMap。

方法

Delete()

删除动态创建的 ListObject 控件，清除工作表中的单元格数据，并将该控件从 ControlCollection 中移除。
Disconnect()

从 ListObject 控件移除数据绑定。
ExportToVisio()

将 ListObject 导出到 Visio。
Publish(Object, Boolean)

将 ListObject 控件发布到运行 Microsoft Windows SharePoint Services 的服务器。
Refresh()

用运行 Microsoft Windows SharePoint Services 的服务器上的当前数据和架构更新 ListObject 控件。
RefreshDataRow(Int32)

更新与指定数据行关联的 ListObject 数据行。
RefreshDataRows()

使用数据源中的数据更新 ListObject 中的所有行。
ResetPersistedBindingInformation()

清除有关用户对 ListObject 控件所做的更改的信息。
Resize(Range)

允许在新范围上调整 ListObject 控件的大小。
SetDataBinding(Object)

将 ListObject 控件绑定到数据源。
SetDataBinding(Object, String)

将 ListObject 控件绑定到数据源的指定数据成员。
SetDataBinding(Object, String, String[])

将 ListObject 控件绑定到数据源的指定数据成员，并且仅显示该数据成员的指定列。
Unlink()

从 ListObject 控件中移除指向 Microsoft Windows SharePoint Services 站点的链接。
Unlist()

从 ListObject 控件中移除列表功能。

事件

BeforeAddDataBoundRow

恰好在尝试向绑定到数据的 ListObject 控件添加新行之前发生。
BeforeDoubleClick

在双击 ListObject 控件时，但在默认双击操作之前发生。
BeforeRightClick

在右击 ListObject 控件时，但在默认右击操作之前发生。
BindingContextChanged
Change

当 ListObject 控件中发生更改时发生。
DataBindingFailure

当某个条件导致 ListObject 控件的数据绑定失败时发生。
DataMemberChanged

当 DataMember 属性的值更改时发生。
DataSourceChanged

当 DataSource 属性的值更改时发生。
Deselected

当所选内容从 ListObject 控件移到 ListObject 控件外部时发生。
ErrorAddDataBoundRow

在用户尝试向数据绑定 ListObject 控件添加行，但是该行无法添加时发生。
OriginalDataRestored

在用户执行被禁止的操作时发生，ListObject 控件随后会恢复回其原始状态。
Selected

当选择 ListObject 控件时发生。
SelectedIndexChanged

当 SelectedIndex 属性的值更改时发生。
SelectionChange

在 ListObject 控件内部的所选内容更改时发生。

适用于