ControlCollection.AddListObject Метод (ListObject) (2007 System)

Статья
11/16/2008

Обновлен: Июль 2008

Добавляет Visual Studio Tools for Office Microsoft.Office.Tools.Excel.ListObject в коллекцию элементов управления, основанную на указанном собственном объекте Microsoft.Office.Interop.Excel.ListObject.

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

Синтаксис

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

returnValue = instance.AddListObject(listObject)

public ListObject AddListObject(
    ListObject listObject
)

Параметры

listObject
Тип: Microsoft.Office.Interop.Excel.ListObject
Собственный объект ListObject.

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

Тип: Microsoft.Office.Tools.Excel.ListObject
Объект Visual Studio Tools for Office Microsoft.Office.Tools.Excel.ListObject, который был добавлен в коллекцию элементов управления.

Исключения

Исключение	Условие
ArgumentNullException	Аргумент listObject равен nullссылка null (Nothing в Visual Basic) или имеет нулевую длину.
ControlNameAlreadyExistsException	Элемент управления ListObject с таким же именем уже добавлен в экземпляр ControlCollection.

Заметки

Не рекомендуется выполнять прямой вызов этого метода из кода. Вместо этого вызовите метод расширения ListObjectExtensions.GetVstoObject, чтобы получить Visual Studio Tools for Office Microsoft.Office.Tools.Excel.ListObject.

Метод расширения ListObjectExtensions.GetVstoObject использует данный метод для создания Visual Studio Tools for Office Microsoft.Office.Tools.Excel.ListObject, который соответствует экземпляру собственного объекта Microsoft.Office.Interop.Excel.ListObject.

Метод расширения ListObjectExtensions.GetVstoObject создает расширенный объект Microsoft.Office.Tools.Excel.ListObject только один раз. Он возвращает тот же экземпляр существующего расширенного объекта при повторных вызовах. Напротив, AddListObject создает новый расширенный объект Microsoft.Office.Tools.Excel.ListObject каждый раз при вызове.

Разрешения

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