NamedRange.ApplyNames 方法

定义

命名空间:

Microsoft.Office.Tools.Excel

程序集:

Microsoft.Office.Tools.Excel.dll

向 NamedRange 控件中的单元格应用名称。

public object ApplyNames (object Names, object IgnoreRelativeAbsolute, object UseRowColumnNames, object OmitColumn, object OmitRow, Microsoft.Office.Interop.Excel.XlApplyNamesOrder Order = Microsoft.Office.Interop.Excel.XlApplyNamesOrder.xlRowThenColumn, object AppendLast);

abstract member ApplyNames : obj * obj * obj * obj * obj * Microsoft.Office.Interop.Excel.XlApplyNamesOrder * obj -> obj

Public Function ApplyNames (Optional Names As Object, Optional IgnoreRelativeAbsolute As Object, Optional UseRowColumnNames As Object, Optional OmitColumn As Object, Optional OmitRow As Object, Optional Order As XlApplyNamesOrder = Microsoft.Office.Interop.Excel.XlApplyNamesOrder.xlRowThenColumn, Optional AppendLast As Object) As Object

参数

Names

Object

要应用的名称的数组。 如果省略此参数，则会向该范围应用此表中的所有名称。

IgnoreRelativeAbsolute

Object

如果无论引用类型为名称还是引用，都将引用替换为名称，则为 true；如果只是将绝对引用替换为绝对名称，将相对引用替换为相对名称，将混合引用替换为混合名称，则为 false。 默认值为 true。

UseRowColumnNames

Object

true 如果找不到指定区域的名称，则使用包含指定区域的行和列区域的名称; false 如果忽略 和 OmitColumnOmitRow 参数，则为 。 默认值为 true。

OmitColumn

Object

如果将整个引用替换为面向行的名称，则为 true。 只有当引用的单元格与公式在同一列中，而且位于面向行的命名范围中时，才能省略面向列的名称。 默认值为 true。

OmitRow

Object

如果将整个引用替换为面向列的名称，则为 true。 只有当引用的单元格与公式在同一行中，而且位于面向列的命名范围中时，才能省略面向行的名称。 默认值为 true。

Order

XlApplyNamesOrder

确定当单元格引用替换为面向行和面向列的区域名称时，首先列出哪个区域名称。可以是以下 XlApplyNamesOrder 常量之一： xlColumnThenRowxlRowThenColumn

AppendLast

Object

true 如果替换 中 Names 名称的定义，并且还替换已定义的姓氏的定义，则为 ; false 如果仅替换 中 Names 名称的定义，则为 。 默认值为 false。

返回

Object

示例

下面的代码示例使用 ApplyNames 方法将一组名称应用于 NamedRange 控件。

此示例适用于文档级自定义项。

private void AddNames()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    string[] s = new string[] { "One", "Two", "Three", "Four", "Five" };
    namedRange1.ApplyNames(s, true, true, true, true,
        Excel.XlApplyNamesOrder.xlColumnThenRow, false);
}

Private Sub AddNames()
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    Dim s() As String = {"One", "Two", "Three", "Four", "Five"}
    namedRange1.ApplyNames(s, True, True, True, True, _
        Excel.XlApplyNamesOrder.xlColumnThenRow, False)
End Sub

注解

可以使用 Array 函数为参数创建名称 Names 列表。

如果要将名称应用于整个工作表，请使用 Cells.ApplyNames。

不能“取消应用”名称;若要删除名称，请使用 Delete 方法。

可选参数

有关可选参数的信息，请参阅 Office 解决方案中的可选参数。