ListObject 接口

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

命名空间：  Microsoft.Office.Tools.Excel
程序集：  Microsoft.Office.Tools.Excel（在 Microsoft.Office.Tools.Excel.dll 中）

语法

声明
<GuidAttribute("48eb309a-698d-4d40-95af-d9d083e63d30")> _
Public Interface ListObject _
    Inherits IBindableComponent, IComponent, IDisposable, ISupportInitialize

[GuidAttribute("48eb309a-698d-4d40-95af-d9d083e63d30")]
public interface ListObject : IBindableComponent, 
    IComponent, IDisposable, ISupportInitialize

ListObject 类型公开以下成员。

属性

	名称	说明
	_Default	基础结构。
	Active	获取一个值，该值指示工作表上的 ListObject 控件是否处于活动状态；即，活动单元格是否位于 ListObject 控件的范围内。
	AlternativeText	获取或设置指定表的说明性（可选）文本字符串。此属性只能用于 Excel 2010 项目中。
	Application	获取一个表示 Microsoft Office Excel 应用程序或 ListObject 创建者的 Application。
	AutoFilter	获取一个筛选的表。
	AutoSelectRows	获取或设置一个值，该值指示在 SelectedIndex 发生更改时是否选择整行。
	AutoSetDataBoundColumnHeaders	获取或设置一个值，该值确定是否自动将列标题设置为与数据源相匹配。
	BindingContext	获取或设置 IBindableComponent 的货币管理器的集合。 （继承自 IBindableComponent。）
	Comment	获取或设置与 ListObject 关联的注释。
	Container	基础结构。
	Creator	获取在其中创建 ListObject 的应用程序。
	DataBindings	获取此 IBindableComponent 的数据绑定对象的集合。 （继承自 IBindableComponent。）
	DataBodyRange	获取一个 Range，它表示包含标题行和插入行之间列表中数据区域的范围。
	DataBoundFormat	获取或设置数据绑定 ListObject 控件的格式样式。
	DataBoundFormatSettings	获取或设置要向 ListObject 控件应用指定 XlRangeAutoFormat 的哪个 FormatSettings。
	DataMember	获取或设置多成员数据源中要绑定到 ListObject 控件的特定数据成员。
	DataSource	获取或设置包含用于填充该控件中的项的值列表的源。
	DefaultDataSourceUpdateMode	获取或设置默认 DataSourceUpdateMode。
	DisplayName	获取或设置显示名称。
	DisplayRightToLeft	获取一个值，该值指示 ListObject 是否从右向左（而非从左向右）显示。
	HeaderRowRange	获取一个表示标题行范围的 Range。
	InnerObject	获取一个 Microsoft.Office.Interop.Excel.ListObject，它表示 Microsoft.Office.Tools.Excel.ListObject 的基础本机对象。
	InsertRowRange	获取一个表示 ListObject 控件的插入行（如果有的话）的 Range。
	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	获取或设置一个值，该值表示总计行是否可见。
	Site	获取或设置与 IComponent 关联的 ISite。 （继承自 IComponent。）
	Sort	获取 ListObject 集合的一个或多个排序列以及排序顺序。
	SourceType	获取列表的当前源。
	Summary	获取或设置与指定表的可选文本字符串关联的说明。此属性只能用于 Excel 2010 项目中。
	TableStyle	获取或设置表样式。
	Tag	获取或设置包含有关 Tag 控件的数据的对象。
	TotalsRowRange	获取一个表示 ListObject 控件的总计行的 Range。
	XmlMap	获取一个表示该列表所用架构映射的 XmlMap。

页首

方法

	名称	说明
	BeginInit	用信号通知对象初始化即将开始。 （继承自 ISupportInitialize。）
	Delete	删除动态创建的 ListObject 控件，清除工作表中的单元格数据，并将该控件从 ControlCollection 中移除。
	Disconnect	从 ListObject 控件中移除数据绑定。
	Dispose	执行与释放或重置非托管资源相关的应用程序定义的任务。 （继承自 IDisposable。）
	EndInit	用信号通知对象初始化已完成。 （继承自 ISupportInitialize。）
	ExportToVisio	将 ListObject 导出到 Visio。
	Publish	将 ListObject 控件发布到运行 Microsoft Windows SharePoint Services 的服务器。
	Refresh	用运行 Microsoft Windows SharePoint Services 的服务器上的当前数据和架构更新 ListObject 控件。
	RefreshDataRow	更新与指定数据行关联的 ListObject 数据行。
	RefreshDataRows	使用数据源中的数据更新 ListObject 中的所有行。
	ResetPersistedBindingInformation	清除有关用户对 ListObject 控件所做的更改的信息。
	Resize	允许在新范围上调整 ListObject 控件的大小。
	SetDataBinding(Object)	将 ListObject 控件绑定到数据源。
	SetDataBinding(Object, String)	将 ListObject 控件绑定到数据源的指定数据成员。
	SetDataBinding(Object, String, array<String[])	将 ListObject 控件绑定到数据源的指定数据成员，并且仅显示该数据成员的指定列。
	Unlink	从 ListObject 控件中移除指向 Microsoft Windows SharePoint Services 站点的链接。
	Unlist	从 Microsoft.Office.Interop.Excel.ListObject 控件中移除列表功能。
	UpdateChanges	用对工作表中 ListObject 控件进行的更改更新 Microsoft Windows SharePoint Services 站点上的列表。

页首

事件

	名称	说明
	BeforeAddDataBoundRow	恰好在尝试向绑定到数据的 ListObject 控件添加新行之前发生。
	BeforeDoubleClick	当在默认的双击操作之前双击 ListObject 控件时发生。
	BeforeRightClick	当在默认的右击操作之前右击 ListObject 控件时发生。
	BindingContextChanged	基础结构。
	Change	当 ListObject 控件中发生更改时发生。
	DataBindingFailure	当某个条件导致 ListObject 控件的数据绑定失败时发生。
	DataMemberChanged	当 DataMember 属性的值更改时发生。
	DataSourceChanged	当 DataSource 属性的值更改时发生。
	Deselected	当所选内容从 ListObject 控件移到 ListObject 控件外部时发生。
	Disposed	表示处理组件的 Disposed 事件的方法。 （继承自 IComponent。）
	ErrorAddDataBoundRow	在用户尝试向数据绑定 ListObject 控件添加行，但是该行无法添加时发生。
	OriginalDataRestored	在用户执行被禁止的操作时发生，ListObject 控件随后会恢复回其原始状态。
	Selected	当选择 ListObject 控件时发生。
	SelectedIndexChanged	当 SelectedIndex 属性的值更改时发生。
	SelectionChange	在 ListObject 控件内部的所选内容更改时发生。

页首

备注

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

提示

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

用法

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

请参见

参考

Microsoft.Office.Tools.Excel 命名空间