Поделиться через

NamedRange.ApplyNames Метод (2007 System)

  • Статья

Обновлен: Ноябрь 2007

Применяет имена к ячейкам в элементе управления NamedRange.

Пространство имен:  Microsoft.Office.Tools.Excel
Сборка:  Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)

Синтаксис

'Декларация
Public 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
'Применение
Dim instance As NamedRange
Dim Names As Object
Dim IgnoreRelativeAbsolute As Object
Dim UseRowColumnNames As Object
Dim OmitColumn As Object
Dim OmitRow As Object
Dim Order As XlApplyNamesOrder
Dim AppendLast As Object
Dim returnValue As Object

returnValue = instance.ApplyNames(Names, _
    IgnoreRelativeAbsolute, UseRowColumnNames, _
    OmitColumn, OmitRow, Order, AppendLast)

public 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 для использования имен диапазонов строк и столбцов, содержащих указанный диапазон, если не удается найти имена для этого диапазона; значение false для пропуска аргументов OmitColumn и OmitRow. Значение по умолчанию — true.
  • OmitColumn
    Тип: System.Object
    Значение true для замены всей ссылки на строчно-ориентированное имя. Столбцово-ориентированное имя может быть пропущено только в том случае, если ячейка, на которую имеется ссылка, находится в одном столбце с формулой и в строчно-ориентированном именованном диапазоне. Значение по умолчанию — true.
  • OmitRow
    Тип: System.Object
    Значение true для замены всей ссылки на столбцово-ориентированное имя. Строчно-ориентированное имя может быть пропущено только в том случае, если ячейка, на которую имеется ссылка, находится в одной строке с формулой и в столбцово-ориентированном именованном диапазоне. Значение по умолчанию — true.
  • Order
    Тип: Microsoft.Office.Interop.Excel.XlApplyNamesOrder
    Определяет, какое имя диапазона указывается первым, когда ссылка на ячейку заменяется на строчно-ориентированное и столбцово-ориентированное имя диапазона.
    Может принимать значение одной из следующих констант XlApplyNamesOrder:
  • AppendLast
    Тип: System.Object
    Значение true для замены определений имен в Names и замены заданных определений фамилий; значение false для замены определений имен только в Names. Значение по умолчанию — 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);
}

Разрешения

См. также

Ссылки

NamedRange Класс

NamedRange - члены

Microsoft.Office.Tools.Excel - пространство имен