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.
Возвращаемое значение
Примеры
В следующем примере кода метод используется 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.