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

Статья
11/16/2008

Обновлен: Ноябрь 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
)

Параметры

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

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.");
}

Разрешения

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