NamedRange 接口

NamedRange 控件是一个具有唯一名称的范围，它可以公开事件并绑定到数据。

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

语法

声明
<GuidAttribute("6b87f7cb-0689-4e7e-8dcb-3c0e654629bb")> _
Public Interface NamedRange _
    Inherits IBindableComponent, IComponent, IDisposable, ISupportInitialize

[GuidAttribute("6b87f7cb-0689-4e7e-8dcb-3c0e654629bb")]
public interface NamedRange : IBindableComponent, 
    IComponent, IDisposable, ISupportInitialize

NamedRange 类型公开以下成员。

属性

	名称	说明
	AddIndent	获取或设置一个值，该值确定在将 NamedRange 控件中的文本对齐方式设置为在水平或垂直方向均匀分布时文本是否自动缩进。
	Address	获取 NamedRange 控件的范围引用。
	AddressLocal	以用户的语言获取 NamedRange 控件的范围引用。
	AllowEdit	获取一个值，该值指示是否可以在受保护的工作表上编辑 NamedRange 控件。
	Application	获取一个表示 NamedRange 控件的创建者的 Microsoft.Office.Interop.Excel.Application。
	Areas	获取一个 Areas 集合，该集合表示多区域选择中的所有范围。
	BindingContext	获取或设置 IBindableComponent 的货币管理器的集合。 （继承自 IBindableComponent。）
	Borders	获取一个表示 NamedRange 控件的边框 Borders 集合。
	Cells	获取一个表示 NamedRange 控件中单元格的 Microsoft.Office.Interop.Excel.Range。
	Characters	获取一个 Microsoft.Office.Interop.Excel.Characters 对象，该对象表示 NamedRange 控件文本中某一范围的字符。
	Column	获取 NamedRange 控件的第一个区域中第一列的编号。
	Columns	获取一个 Microsoft.Office.Interop.Excel.Range，它表示 NamedRange 控件中的一列或多个列。
	ColumnWidth	获取或设置 NamedRange 控件中所有列的宽度。
	Comment	获取一个 Comment，它表示与 NamedRange 控件左上角中的单元格相关联的注释。
	Container	基础结构。
	Count	获取 NamedRange 控件中单元格的数目。
	CountLarge	获取 NamedRange 控件中单元格的数目。
	Creator	获取一个 32 位整数，该整数指示已在其中创建 NamedRange 控件的应用程序。
	CurrentArray	如果 NamedRange 控件属于某个数组，则获取一个表示整个数组的 Microsoft.Office.Interop.Excel.Range。
	CurrentRegion	获取一个表示当前区域的 Microsoft.Office.Interop.Excel.Range。
	DataBindings	获取此 IBindableComponent 的数据绑定对象的集合。 （继承自 IBindableComponent。）
	DefaultDataSourceUpdateMode	获取或设置默认 DataSourceUpdateMode。
	Dependents	获取一个 Microsoft.Office.Interop.Excel.Range，它表示包含 NamedRange 控件的所有依赖单元格的范围。
	DirectDependents	获取一个 Microsoft.Office.Interop.Excel.Range，它表示包含 NamedRange 控件的所有直接依赖单元格的范围。
	DirectPrecedents	获取一个 Microsoft.Office.Interop.Excel.Range，它表示包含 NamedRange 控件的所有直接引用单元格的范围。
	DisplayFormat	获取一个对象，该对象表示指定范围的显示设置。
	End	获取一个 Microsoft.Office.Interop.Excel.Range，它表示包含 NamedRange 控件的区域末尾的单元格。
	EntireColumn	获取一个 Microsoft.Office.Interop.Excel.Range，它表示包含 NamedRange 控件的整列（或多列）。
	EntireRow	获取一个 Microsoft.Office.Interop.Excel.Range，它表示包含 NamedRange 控件的整行（或多行）。
	Errors	获取一个使您可以访问错误检查选项的 Errors 对象。
	Font	获取一个表示 NamedRange 控件的字体的 Font。
	FormatConditions	获取一个 FormatConditions 集合，该集合表示 NamedRange 控件的所有条件格式。
	Formula	获取或设置 NamedRange 控件的用 A1 样式表示法表示的公式。
	FormulaArray	获取或设置 NamedRange 控件的数组公式。
	FormulaHidden	获取或设置一个值，该值指示在工作表受到保护时，是否隐藏 NamedRange 控件中的公式。
	FormulaLabel	获取或设置 NamedRange 控件的公式标签类型。
	FormulaLocal	获取或设置 NamedRange 控件的公式，该公式使用用户语言的 A1 样式的引用。
	FormulaR1C1	获取或设置该对象的用 R1C1 样式表示法表示的公式。
	FormulaR1C1Local	获取或设置 NamedRange 控件的公式，该公式使用用户语言的 R1C1 样式表示法。
	HasArray	获取一个值，该值指示 NamedRange 控件是否属于数组公式。
	HasFormula	获取一个值，该值指示 NamedRange 控件中的所有单元格是否包含公式。
	Height	获取 NamedRange 控件的高度。
	Hidden	获取或设置一个对象，该对象指示是否隐藏行或列。
	HorizontalAlignment	获取或设置 NamedRange 控件的水平对齐方式。
	Hyperlinks	获取一个 Hyperlinks 集合，该集合表示 NamedRange 控件中的超链接。
	ID	在将该页另存为网页时，获取或设置 NamedRange 控件的标识标签。
	IndentLevel	获取或设置 NamedRange 控件的缩进级别。
	InnerObject	获取一个 Microsoft.Office.Interop.Excel.Range，它表示 Microsoft.Office.Tools.Excel.NamedRange 的基础本机对象。
	Interior	获取一个 Interior，它表示 NamedRange 控件的内部。
	Item	获取一个 Microsoft.Office.Interop.Excel.Range，它表示距离 NamedRange 控件的某偏移量处的范围。
	Left	获取从列 A 的左边缘到 NamedRange 控件的左边缘的距离。
	ListHeaderRows	获取 NamedRange 控件的标题行的数目。
	ListObject	获取 NamedRange 控件的 Microsoft.Office.Interop.Excel.ListObject。
	LocationInTable	获取一个常数，该常数描述包含 NamedRange 控件左上角的 PivotTable 报表部分。
	Locked	获取或设置一个值，该值指示 NamedRange 控件是否处于锁定状态。
	MDX	获取指定的 NamedRange 对象的 MDX 名称。
	MergeArea	获取一个 Microsoft.Office.Interop.Excel.Range，它表示包含 NamedRange 控件的合并范围。
	MergeCells	获取或设置一个值，该值指示 NamedRange 控件是否包含合并单元格。
	Name	获取或设置 NamedRange 控件的 Name 对象。
	Next	获取一个表示下一个单元格的 Microsoft.Office.Interop.Excel.Range。
	NumberFormat	获取或设置 NamedRange 控件的格式代码。
	NumberFormatLocal	获取或设置 NamedRange 控件的采用用户语言的格式代码。
	Offset	获取一个 Microsoft.Office.Interop.Excel.Range，它表示距离 NamedRange 控件的偏移量。
	Orientation	获取或设置文本方向。
	OutlineLevel	获取或设置 NamedRange 控件的当前大纲级别。
	PageBreak	获取或设置分页符的位置。
	Parent	获取 NamedRange 控件的父对象。
	Phonetic	获取 Phonetic 对象，该对象包含有关 NamedRange 控件中特定拼音文本字符串的信息。
	Phonetics	获取 NamedRange 控件的 Phonetics 集合。
	PivotCell	获取一个 PivotCell，它表示数据透视表中的一个单元格。
	PivotField	获取一个 PivotField，它表示包含 NamedRange 控件左上角的数据透视表字段。
	PivotItem	获取一个 PivotItem，它表示包含 NamedRange 控件左上角的数据透视表项。
	PivotTable	获取一个 PivotTable，它表示包含 NamedRange 控件左上角的数据透视表或者与数据透视图报表相关联的数据透视表。
	Precedents	获取一个 Microsoft.Office.Interop.Excel.Range，它表示 NamedRange 控件的所有引用单元格。
	PrefixCharacter	获取 NamedRange 控件的前缀字符。
	Previous	获取一个表示上一个单元格的 Microsoft.Office.Interop.Excel.Range。
	QueryTable	获取一个 QueryTable，它表示与 NamedRange 控件相交的查询表。
	ReadingOrder	获取或设置 NamedRange 控件的读取顺序。
	RefersTo	获取或设置 NamedRange 控件定义为引用的公式（使用 A1 样式表示法）。
	RefersToLocal	获取或设置 NamedRange 控件定义为引用的公式（使用 A1 样式表示法并采用用户语言）。
	RefersToR1C1	获取或设置 NamedRange 控件定义为引用的公式（使用 R1C1 样式表示法）。
	RefersToR1C1Local	获取或设置 NamedRange 控件定义为引用的公式（使用 R1C1 样式表示法并采用用户语言）。
	RefersToRange	获取由 NamedRange 控件引用的 Microsoft.Office.Interop.Excel.Range。
	Resize	获取一个基于 NamedRange 控件调整大小的 Microsoft.Office.Interop.Excel.Range。
	Row	获取 NamedRange 控件的第一个区域中第一行的编号。
	RowHeight	获取或设置 NamedRange 控件中所有行的高度（以磅为度量单位）。
	Rows	获取一个 Microsoft.Office.Interop.Excel.Range，它表示 NamedRange 控件中的一行或多个行。
	ServerActions	获取可以在 Microsoft Office SharePoint 服务器上对 NamedRange 对象执行的操作。
	ShowDetail	获取和设置一个对象，该对象指示是否展开了 NamedRange 控件的大纲（以便列或行的详细信息可见）。
	ShrinkToFit	获取或设置一个值，该值指示文本是否自动缩小以适合可用的列宽。
	Site	获取或设置与 IComponent 关联的 ISite。 （继承自 IComponent。）
	SmartTags	获取一个 SmartTags 对象，该对象表示 NamedRange 控件的标识符。
	SoundNote	基础结构。
	SparklineGroups	获取一个对象，该对象表示来自指定范围的现有迷你图组。
	Style	获取或设置一个表示 NamedRange 控件的样式的 Style。
	Summary	获取一个值，该值指示此范围是否为大纲摘要行或列。
	Tag	获取或设置包含有关 Tag 控件的数据的对象。
	Text	获取 NamedRange 控件的文本。
	Top	获取第 1（一）行的上边缘到 NamedRange 控件的上边缘之间的距离（以磅为单位）。
	UseStandardHeight	获取或设置一个值，该值指示 NamedRange 控件的行高是否等于此表的标准高度。
	UseStandardWidth	获取或设置一个值，该值指示 NamedRange 控件的列宽是否等于此表的标准宽度。
	Validation	获取一个 Validation 对象，该对象表示 NamedRange 控件的数据验证。
	Value	获取或设置 NamedRange 控件的值。
	Value2	获取或设置 NamedRange 控件的值。
	VerticalAlignment	获取或设置 NamedRange 控件的垂直对齐方式。
	Width	获取 NamedRange 控件的宽度（以磅为单位）。
	Worksheet	获取一个 Microsoft.Office.Interop.Excel.Worksheet，它表示包含 NamedRange 控件的工作表。
	WrapText	获取或设置一个值，该值指示 Microsoft Office Excel 是否对 NamedRange 控件中的文本进行换行。
	XPath	获取一个 XPath，它表示映射到 NamedRange 控件的元素的 Xpath。

页首

方法

	名称	说明
	_PasteSpecial	基础结构。
	_PrintOut	基础结构。
	Activate	激活单个单元格 NamedRange 控件。
	AddComment	向 NamedRange 控件添加注释。
	AdvancedFilter	基于条件范围从列表筛选或复制数据。
	AllocateChanges	基于 OLAP 数据源为命名范围内的所有已编辑单元格执行写回操作。此方法只能用于 Excel 2010 项目中。
	ApplyNames	向 NamedRange 控件中的单元格应用名称。
	ApplyOutlineStyles	向 NamedRange 控件应用大纲样式。
	AutoComplete	从列表中获取 AutoComplete 匹配项。
	AutoFill	自动填充 NamedRange 控件中的单元格。
	AutoFilter	使用“自动筛选”筛选列表。
	AutoFit	更改 NamedRange 控件中的列宽或行高以实现最佳匹配。
	AutoFormat	使用预定义的格式自动格式化 NamedRange 控件。
	AutoOutline	自动为 NamedRange 控件创建大纲。
	BeginInit	用信号通知对象初始化即将开始。 （继承自 ISupportInitialize。）
	BorderAround	向 NamedRange 控件添加一个边框，并设置新边框的 Color、LineStyle 和 Weight 属性。
	BorderAround2	向 NamedRange 控件添加一个边框，并设置新边框的 Color、LineStyle 和 Weight 属性。
	Calculate	计算 NamedRange 控件中单元格的值。
	CalculateRowMajorOrder	计算某个特定范围的单元格。
	CheckSpelling	检查 NamedRange 控件中文本的拼写。
	Clear	清除整个 NamedRange 控件。
	ClearComments	从 NamedRange 控件中清除所有单元格注释。
	ClearContents	从 NamedRange 控件中清除公式。
	ClearFormats	清除 NamedRange 控件的格式。
	ClearHyperlinks	从指定范围移除所有超链接。
	ClearNotes	从 NamedRange 控件中的所有单元格清除注释。
	ClearOutline	清除 NamedRange 控件的大纲。
	ColumnDifferences	获取一个 Microsoft.Office.Interop.Excel.Range，它表示每一列中其内容与比较单元格不同的所有单元格。
	Consolidate	将多个工作表中多个范围中的数据合并到 NamedRange 控件中。
	Copy	将 NamedRange 控件的内容复制到指定的范围或剪贴板。
	CopyFromRecordset	从 NamedRange 控件的左上角开始，将 ADO 或 DAO 记录集的内容复制到工作表中。
	CopyPicture	将 NamedRange 控件作为图片复制到剪贴板。
	CreateNames	在 NamedRange 控件中基于表中的文本标签创建名称。
	CreatePublisher	基础结构。
	Cut	将 NamedRange 控件的内容剪切到剪贴板，或者将它复制到指定的目标。
	DataSeries	在 NamedRange 控件中创建一个数据系列。
	Delete	删除动态创建的 NamedRange 控件并将其从 ControlCollection 中移除。
	DialogBox	显示由 Microsoft Office Excel 4.0 宏工作表上的对话框定义表定义的对话框。
	Dirty	指定要在下一次重新计算时重新计算的 NamedRange 控件。
	DiscardChanges	放弃范围内已编辑单元格中的所有更改。此方法只能用于 Excel 2010 项目中。
	Dispose	执行与释放或重置非托管资源相关的应用程序定义的任务。 （继承自 IDisposable。）
	EditionOptions	基础结构。
	EndInit	用信号通知对象初始化已完成。 （继承自 ISupportInitialize。）
	ExportAsFixedFormat	导出到指定格式的文件。
	FillDown	从 NamedRange 控件中的顶端单元格向下填充到 NamedRange 控件的底端。
	FillLeft	从 NamedRange 控件最右侧的单元格向左填充。
	FillRight	从 NamedRange 控件中最左侧的单元格向右填充。
	FillUp	从 NamedRange 控件中的底端单元格向上填充到该范围的顶端。
	Find	在 NamedRange 控件中查找特定的信息，然后返回一个 Microsoft.Office.Interop.Excel.Range 对象，该对象表示在其中找到此信息的第一个单元格。
	FindNext	继续执行用 Find 方法开始的搜索。
	FindPrevious	继续执行用 Find 方法开始的搜索。
	FunctionWizard	对 NamedRange 控件左上角的单元格启动“函数向导”。
	get_Address	基础结构。请使用 Address 属性而不要使用此方法。
	get_AddressLocal	基础结构。请使用 AddressLocal 属性而不要使用此方法。
	get_Characters	基础结构。请使用 Characters 属性而不要使用此方法。
	get_End	基础结构。请使用 End 属性而不要使用此方法。
	get_Item	基础结构。请使用 Item 属性而不要使用此方法。
	get_Offset	基础结构。请使用 Offset 属性而不要使用此方法。
	get_Range	基础结构。
	get_Resize	基础结构。请使用 Resize 属性而不要使用此方法。
	get_Value	获取 NamedRange 控件的值。
	GetEnumerator	获取一个 IEnumerator，它可用于循环访问 NamedRange 控件中的单元格。
	GoalSeek	计算实现特定目标所必需的值。
	Group	当 NamedRange 控件表示数据透视表字段的数据范围中的单个单元格时，Group 方法在该字段中执行基于数值或日期的分组。
	Insert	在 NamedRange 控件中插入一个单元格或某一范围的单元格，并移走其他单元格以腾出空间。
	InsertIndent	向 NamedRange 控件添加一个缩进量。
	Justify	重新排列 NamedRange 控件中的文本，以便它在该范围中均匀填充。
	ListNames	从 NamedRange 控件中的第一个单元格开始，将所显示的全部名称的列表粘贴到工作表中。
	Merge	从 NamedRange 控件创建一个合并单元格。
	NavigateArrow	将 NamedRange 控件的跟踪标志箭头定位到引用单元格、依赖单元格或导致错误的单元格。
	NoteText	获取或设置与 NamedRange 控件左上角中的单元格相关联的单元格注释。
	Parse	分析某一范围的数据并将它分成多个单元格。
	PasteSpecial	将剪贴板上 Microsoft.Office.Interop.Excel.Range 对象的内容粘贴到 NamedRange 控件中。
	PrintOut	打印 NamedRange 控件。
	PrintOutEx	打印对象。
	PrintPreview	显示 NamedRange 控件的预览（显示打印时的外观）。
	RemoveDuplicates	从某一范围的值中移除重复值。
	RemoveSubtotal	从 NamedRange 控件中移除小计。
	Replace	将 NamedRange 控件中指定的字符替换为新字符串。
	RowDifferences	获取一个 Microsoft.Office.Interop.Excel.Range 对象，该对象表示内容与每一行中的比较单元格不同的所有单元格。
	Run	基础结构。
	Select	选择 NamedRange 控件。
	set_Item	基础结构。请使用 Item 属性而不要使用此方法。
	set_Value	设置 NamedRange 控件的值。
	SetPhonetic	为 NamedRange 控件中的所有单元格创建 Phonetic 对象。
	Show	在活动窗口的内容中滚动，以便将 NamedRange 控件移到视图中。
	ShowDependents	绘制指向 NamedRange 控件的直接依赖单元格的跟踪标志箭头。
	ShowErrors	绘制通过引用单元格树指向作为错误源的单元格的跟踪标志箭头，然后返回包含该单元格的 Microsoft.Office.Interop.Excel.Range 对象。
	ShowPrecedents	绘制指向 NamedRange 控件的直接引用单元格的跟踪标志箭头。
	Sort	对 NamedRange 控件中的数据进行排序。
	SortSpecial	使用东亚排序方法对 NamedRange 控件进行排序。例如，在日语中，按照假名音节表顺序进行排序。有关更多信息，请参见参数列表。
	Speak	导致按行顺序或列顺序朗读 NamedRange 控件的单元格。
	SpecialCells	获取一个 Microsoft.Office.Interop.Excel.Range 对象，该对象表示与指定的类型和值相匹配的所有单元格。
	SubscribeTo	基础结构。
	Subtotal	为 NamedRange 控件创建小计。
	Table	基于在工作表中定义的输入值和公式创建数据表。
	TextToColumns	将包含文本的单元格所在的列分析为几列。
	Ungroup	提升大纲中的 NamedRange 控件（即，降低它的大纲级别）。
	UnMerge	将一个合并区域分成多个单元格。

页首

事件

	名称	说明
	BeforeDoubleClick	当在默认的双击操作之前双击 NamedRange 控件时发生。
	BeforeRightClick	当在默认的右击操作之前右击 NamedRange 控件时发生。
	BindingContextChanged	基础结构。
	Change	当 NamedRange 控件中发生更改时发生。
	Deselected	当所选内容从 NamedRange 控件移到 NamedRange 控件外部的区域时发生。
	Disposed	表示处理组件的 Disposed 事件的方法。 （继承自 IComponent。）
	Selected	当选择 NamedRange 控件时发生。
	SelectionChange	在 NamedRange 控件内部的所选内容更改时发生。

页首

备注

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

提示

此接口由 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 命名空间