Поделиться через


ControlCollection.AddListObject Метод (Range, String) (2007 System)

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

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

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

Синтаксис

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

returnValue = instance.AddListObject(range, _
    name)
public ListObject AddListObject(
    Range range,
    string name
)

Параметры

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

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

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

Исключения

Исключение Условие
ArgumentNullException

Аргумент имени или диапазона равен nullссылка null (Nothing в Visual Basic), или аргумент имени имеет нулевую длину.

ControlNameAlreadyExistsException

Элемент управления с таким именем уже имеется в данном экземпляре ControlCollection.

InvalidRangeException

Указанный диапазон не существует. Невозможно использовать диапазоны с несколькими областями. Диапазон должен находиться на том же листе, что и экземпляр ControlCollection.

Заметки

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

Примеры

В приведенном ниже примере кода в верхнюю часть листа добавляется элемент управления ListObject, после чего отображается окно сообщения с числом строк в ListObject.

Private Sub ExcelAddListObject()
    Dim List1 As Microsoft.Office.Tools.Excel. _
        ListObject = Me.Controls.AddListObject( _
        Me.Range("A1", "C5"), "List1")

    MessageBox.Show("The list object has " _
        & List1.Range.Rows.Count.ToString() + " rows.")

End Sub
private void ExcelAddListObject()
{
    Microsoft.Office.Tools.Excel.ListObject list1 =
        this.Controls.AddListObject(this.Range["A1", "C5"], 
        "list1");
    MessageBox.Show("The list object has " + 
        list1.Range.Rows.Count.ToString() + " rows.");
}

Разрешения

См. также

Ссылки

ControlCollection Класс

ControlCollection - члены

AddListObject - перегрузка

Microsoft.Office.Tools.Excel - пространство имен