NamedRange 接口

定义

命名空间:

Microsoft.Office.Tools.Excel

程序集:

Microsoft.Office.Tools.Excel.dll

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

public interface class NamedRange : IDisposable, System::ComponentModel::IComponent, System::ComponentModel::ISupportInitialize, System::Windows::Forms::IBindableComponent

[System.Runtime.InteropServices.Guid("6b87f7cb-0689-4e7e-8dcb-3c0e654629bb")]
public interface NamedRange : IDisposable, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent

[<System.Runtime.InteropServices.Guid("6b87f7cb-0689-4e7e-8dcb-3c0e654629bb")>]
type NamedRange = interface
    interface IBindableComponent
    interface IComponent
    interface IDisposable
    interface ISupportInitialize

Public Interface NamedRange
Implements IBindableComponent, IComponent, IDisposable, ISupportInitialize

属性

GuidAttribute

实现

IComponent ISupportInitialize IDisposable IBindableComponent

注解

有关详细信息，请参阅 NamedRange 控件。

注意

此接口由 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。

属性

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

方法

Activate()	激活单个单元格 NamedRange 控件。
AddComment(Object)	向 NamedRange 控件添加注释。
AdvancedFilter(XlFilterAction, Object, Object, Object)	基于条件范围从列表筛选或复制数据。
AllocateChanges()	基于 OLAP 数据源为命名范围内的所有已编辑单元格执行写回操作。
ApplyNames(Object, Object, Object, Object, Object, XlApplyNamesOrder, Object)	向 NamedRange 控件中的单元格应用名称。
ApplyOutlineStyles()	向 NamedRange 控件应用大纲样式。
AutoComplete(String)	从列表中获取一个 AutoComplete 匹配。
AutoFill(Range, XlAutoFillType)	自动填充 NamedRange 控件中的单元格。
AutoFilter(Object, Object, XlAutoFilterOperator, Object, Object)	使用“自动筛选”筛选列表。
AutoFit()	更改 NamedRange 控件中的列宽或行高以实现最佳匹配。
AutoOutline()	自动为 NamedRange 控件创建大纲。
BorderAround2(Object, XlBorderWeight, XlColorIndex, Object, Object)	向 NamedRange 控件添加一个边框，并设置新边框的 Color、LineStyle 和 Weight 属性。
Calculate()	计算 NamedRange 控件中单元格的值。
CalculateRowMajorOrder()	计算某个特定范围的单元格。
CheckSpelling(Object, Object, Object, Object)	检查 NamedRange 控件中文本的拼写。
Clear()	清除整个 NamedRange 控件。
ClearComments()	从 NamedRange 控件中清除所有单元格注释。
ClearContents()	从 NamedRange 控件中清除公式。
ClearFormats()	清除 NamedRange 控件的格式。
ClearHyperlinks()	从指定范围移除所有超链接。
ClearNotes()	从 NamedRange 控件中的所有单元格清除注释。
ClearOutline()	清除 NamedRange 控件的大纲。
ColumnDifferences(Object)	获取一个 Range，它表示每一列中其内容与比较单元格不同的所有单元格。
Consolidate(Object, Object, Object, Object, Object)	将多个工作表中多个范围中的数据合并到 NamedRange 控件中。
Copy(Object)	将 NamedRange 控件的内容复制到指定的范围或剪贴板。
CopyFromRecordset(Object, Object, Object)	从 NamedRange 控件的左上角开始，将 ADO 或 DAO 记录集的内容复制到工作表中。
CopyPicture(XlPictureAppearance, XlCopyPictureFormat)	将 NamedRange 控件作为图片复制到剪贴板。
CreateNames(Object, Object, Object, Object)	在 NamedRange 控件中基于表中的文本标签创建名称。
Cut(Object)	将 NamedRange 控件的内容剪切到剪贴板，或者将它复制到指定的目标。
DataSeries(Object, XlDataSeriesType, XlDataSeriesDate, Object, Object, Object)	在 NamedRange 控件中创建一个数据系列。
Delete()	删除动态创建的 NamedRange 控件并将其从 ControlCollection 中移除。
DialogBox()	显示由 Microsoft Office Excel 4.0 宏工作表上的对话框定义表定义的对话框。
Dirty()	指定要在下一次重新计算时重新计算的 NamedRange 控件。
DiscardChanges()	放弃范围内已编辑单元格中的所有更改。
EditionOptions(XlEditionType, XlEditionOptionsOption, Object, Object, XlPictureAppearance, XlPictureAppearance, Object)	NamedRange 控件是一个具有唯一名称的范围，它可以公开事件并绑定到数据。
ExportAsFixedFormat(XlFixedFormatType, Object, Object, Object, Object, Object, Object, Object, Object)	导出到指定格式的文件。
FillDown()	从 NamedRange 控件中的顶端单元格向下填充到 NamedRange 控件的底端。
FillLeft()	从 NamedRange 控件最右侧的单元格向左填充。
FillRight()	从 NamedRange 控件中最左侧的单元格向右填充。
FillUp()	从 NamedRange 控件中的底端单元格向上填充到该范围的顶端。
Find(Object, Object, Object, Object, Object, XlSearchDirection, Object, Object, Object)	在 NamedRange 控件中查找特定的信息，然后返回一个 Range 对象，该对象表示在其中找到此信息的第一个单元格。
FindNext(Object)	继续执行用 Find(Object, Object, Object, Object, Object, XlSearchDirection, Object, Object, Object) 方法开始的搜索。
FindPrevious(Object)	继续执行用 Find(Object, Object, Object, Object, Object, XlSearchDirection, Object, Object, Object) 方法开始的搜索。
FunctionWizard()	对 控件左上角的单元格启动“函数向导”NamedRange。
get_Value(Object)	获取控件的值 NamedRange 。
GetEnumerator()	获取一个 IEnumerator，它可用于循环访问 NamedRange 控件中的单元格。
Group(Object, Object, Object, Object)	当 NamedRange 控件表示数据透视表字段的数据范围中的单个单元格时，Group(Object, Object, Object, Object) 方法在该字段中执行基于数值或日期的分组。
Insert(Object, Object)	在 NamedRange 控件中插入一个单元格或某一范围的单元格，并移走其他单元格以腾出空间。
InsertIndent(Int32)	向 NamedRange 控件添加缩进。
Justify()	重新排列 NamedRange 控件中的文本，以便它在该范围中均匀填充。
ListNames()	从 NamedRange 控件中的第一个单元格开始，将所显示的全部名称的列表粘贴到工作表中。
Merge(Object)	从 NamedRange 控件创建一个合并单元格。
NavigateArrow(Object, Object, Object)	将 NamedRange 控件的跟踪标志箭头定位到引用单元格、依赖单元格或导致错误的单元格。
NoteText(Object, Object, Object)	获取或设置与 NamedRange 控件左上角中的单元格相关联的单元格注释。
Parse(Object, Object)	分析某一范围的数据并将它分成多个单元格。
PasteSpecial(XlPasteType, XlPasteSpecialOperation, Object, Object)	将剪贴板上 Range 对象的内容粘贴到 NamedRange 控件中。
PrintOutEx(Object, Object, Object, Object, Object, Object, Object, Object)	打印对象。
PrintPreview(Object)	显示 NamedRange 控件的预览（显示打印时的外观）。
RemoveDuplicates(Object, XlYesNoGuess)	从某一范围的值中移除重复值。
RemoveSubtotal()	从 NamedRange 控件中移除小计。
Replace(Object, Object, Object, Object, Object, Object, Object, Object)	将 NamedRange 控件中指定的字符替换为新字符串。
RowDifferences(Object)	获取一个 Range 对象，该对象表示内容与每一行中的比较单元格不同的所有单元格。
Select()	选择 NamedRange 控件。
set_Value(Object, Object)	设置 控件的值 NamedRange 。
SetPhonetic()	为 Phonetic 控件中的所有单元格创建 NamedRange 对象。
Show()	在活动窗口的内容中滚动，以便将 NamedRange 控件移到视图中。
ShowDependents(Object)	绘制指向 NamedRange 控件的直接依赖单元格的跟踪标志箭头。
ShowErrors()	绘制通过引用单元格树指向作为错误源的单元格的跟踪标志箭头，然后返回包含该单元格的 Range 对象。
ShowPrecedents(Object)	绘制指向 NamedRange 控件的直接引用单元格的跟踪标志箭头。
Sort(Object, XlSortOrder, Object, Object, XlSortOrder, Object, XlSortOrder, XlYesNoGuess, Object, Object, XlSortOrientation, XlSortMethod, XlSortDataOption, XlSortDataOption, XlSortDataOption)	对 NamedRange 控件中的数据进行排序。
SortSpecial(XlSortMethod, Object, XlSortOrder, Object, Object, XlSortOrder, Object, XlSortOrder, XlYesNoGuess, Object, Object, XlSortOrientation, XlSortDataOption, XlSortDataOption, XlSortDataOption)	使用东亚排序方法对 NamedRange 控件进行排序。 例如，在日语中，按照假名音节表顺序进行排序。 有关更多信息，请参见参数列表。
Speak(Object, Object)	导致按行顺序或列顺序朗读 NamedRange 控件的单元格。
SpecialCells(XlCellType, Object)	获取一个 Range 对象，该对象表示与指定的类型和值相匹配的所有单元格。
SubscribeTo(String, XlSubscribeToFormat)	NamedRange 控件是一个具有唯一名称的范围，它可以公开事件并绑定到数据。
Subtotal(Int32, XlConsolidationFunction, Object, Object, Object, XlSummaryRow)	为 NamedRange 控件创建小计。
Table(Object, Object)	基于在工作表中定义的输入值和公式创建数据表。
TextToColumns(Object, XlTextParsingType, XlTextQualifier, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)	将包含文本的单元格所在的列分析为几列。
Ungroup()	提升大纲中的 NamedRange 控件（即，降低它的大纲级别）。
UnMerge()	将一个合并区域分成多个单元格。

事件

BeforeDoubleClick	当在默认的双击操作之前双击 NamedRange 控件时发生。
BeforeRightClick	当在默认的右击操作之前右击 NamedRange 控件时发生。
BindingContextChanged	NamedRange 控件是一个具有唯一名称的范围，它可以公开事件并绑定到数据。
Change	当 NamedRange 控件中发生更改时发生。
Deselected	当所选内容从 NamedRange 控件移到 NamedRange 控件外部的区域时发生。
Selected	当选择 NamedRange 控件时发生。
SelectionChange	在 NamedRange 控件内部的所选内容更改时发生。