通过

NamedRange.ApplyNames 方法

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

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

语法

声明
Function ApplyNames ( _
    Names As Object, _
    IgnoreRelativeAbsolute As Object, _
    UseRowColumnNames As Object, _
    OmitColumn As Object, _
    OmitRow As Object, _
    Order As XlApplyNamesOrder, _
    AppendLast As Object _
) As Object

Object ApplyNames(
    Object Names,
    Object IgnoreRelativeAbsolute,
    Object UseRowColumnNames,
    Object OmitColumn,
    Object OmitRow,
    XlApplyNamesOrder Order,
    Object AppendLast
)

参数

  • Names
    类型：System.Object
    要应用的名称的数组。如果省略此参数，则会向该范围应用此表中的所有名称。
  • IgnoreRelativeAbsolute
    类型：System.Object
    如果无论引用类型为名称还是引用，都将引用替换为名称，则为 true；如果只是将绝对引用替换为绝对名称，将相对引用替换为相对名称，将混合引用替换为混合名称，则为 false。默认值为 true。
  • UseRowColumnNames
    类型：System.Object
    如果在找不到指定范围的名称时使用包含该范围的行和列范围的名称，则为 true；如果忽略 OmitColumn 和 OmitRow 参数，则为 false。默认值为 true。
  • OmitColumn
    类型：System.Object
    如果将整个引用替换为面向行的名称，则为 true。只有当引用的单元格与公式在同一列中，而且位于面向行的命名范围中时，才能省略面向列的名称。默认值为 true。
  • OmitRow
    类型：System.Object
    如果将整个引用替换为面向列的名称，则为 true。只有当引用的单元格与公式在同一行中，而且位于面向列的命名范围中时，才能省略面向行的名称。默认值为 true。
  • AppendLast
    类型：System.Object
    如果替换 Names 中名称的定义，还替换上次定义的名称的定义，则为 true；如果仅替换 Names 中名称的定义，则为 false。默认值为 false。

返回值

类型：System.Object

备注

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

如果要向整个表应用名称，请使用 Cells.ApplyNames。

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

可选参数

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

示例

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

此示例针对的是文档级自定义项。

    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


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);
}

.NET Framework 安全性

请参见

参考

NamedRange 接口

Microsoft.Office.Tools.Excel 命名空间