ControlCollection.AddNamedRange Метод (2007 System)

Статья
11/16/2008

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

Добавляет в указанный диапазон листа новый элемент управления NamedRange.

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

Синтаксис

'Декларация
Public Function AddNamedRange ( _
    range As Range, _
    name As String _
) As NamedRange
'Применение
Dim instance As ControlCollection
Dim range As Range
Dim name As String
Dim returnValue As NamedRange

returnValue = instance.AddNamedRange(range, _
    name)

public NamedRange AddNamedRange(
    Range range,
    string name
)

Параметры

range
Тип: Microsoft.Office.Interop.Excel.Range
Объект Range, предоставляющий границы элемента управления.

name
Тип: System.String
Имя элемента управления, которое можно использовать для индексации элемента управления в экземпляре ControlCollection.

Возвращаемое значение

Тип: Microsoft.Office.Tools.Excel.NamedRange
Элемент управления NamedRange, добавленный в экземпляр ControlCollection.

Исключения

Исключение	Условие
ArgumentNullException	Аргумент имени или диапазона равен nullссылка null (Nothing в Visual Basic), или аргумент имени имеет нулевую длину.
ControlNameAlreadyExistsException	Элемент управления с таким именем уже имеется в данном экземпляре ControlCollection.
InvalidRangeException	Указанный диапазон не существует. Невозможно использовать диапазоны с несколькими областями. Диапазон должен находиться на том же листе, что и экземпляр ControlCollection.

Заметки

Метод AddNamedRange используется для добавления элементов управления NamedRange в конец ControlCollection. Чтобы удалить добавленный программно элемент управления NamedRange, воспользуйтесь методом Remove().

Примеры

В следующем примере кода добавляется элемент управления NamedRange в ячейку A1, и затем устанавливает значение именованного диапазона на 100%.

Private Sub ExcelAddNamedRange()

    Dim NamedRange1 As Microsoft.Office.Tools. _
      Excel.NamedRange = Me.Controls.AddNamedRange( _
      Me.Range("A1"), "NamedRange1")
    NamedRange1.Value2 = "100%"

End Sub

private void ExcelAddNamedRange()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", missing],
        "namedRange1");
    namedRange1.Value2 = "100%";
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.