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