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 , чтобы игнорировать аргументы 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.