NamedRange.ApplyNames(Object, Object, Object, Object, Object, XlApplyNamesOrder, Object) Метод

Определение

Применяет имена к ячейкам в элементе управления 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);

Параметры

Names
Object

Массив имен, которые необходимо применить. Если этот аргумент не указан, все имена на листе применяются к диапазону.

IgnoreRelativeAbsolute
Object

Значение true для замены ссылок на имена независимо от ссылочных типов имен или ссылок; значение false для замены абсолютных ссылок только на абсолютные имена, относительных ссылок только на относительные имена, а смешанных ссылок только на смешанные имена. Значение по умолчанию — true.

UseRowColumnNames
Object

Значение true для использования имен диапазонов строк и столбцов, содержащих указанный диапазон, если не удается найти имена для этого диапазона; значение false для пропуска аргументов OmitColumn и OmitRow. Значение по умолчанию — 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.

Применяется к