ListObjects.Add Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает новый объект списка. ListObject Возвращает объект .
public Microsoft.Office.Interop.Excel.ListObject Add (Microsoft.Office.Interop.Excel.XlListObjectSourceType SourceType = Microsoft.Office.Interop.Excel.XlListObjectSourceType.xlSrcRange, object Source, object LinkSource, Microsoft.Office.Interop.Excel.XlYesNoGuess XlListObjectHasHeaders = Microsoft.Office.Interop.Excel.XlYesNoGuess.xlGuess, object Destination);Public Function Add (Optional SourceType As XlListObjectSourceType = Microsoft.Office.Interop.Excel.XlListObjectSourceType.xlSrcRange, Optional Source As Object, Optional LinkSource As Object, Optional XlListObjectHasHeaders As XlYesNoGuess = Microsoft.Office.Interop.Excel.XlYesNoGuess.xlGuess, Optional Destination As Object) As ListObjectПараметры
- SourceType
- XlListObjectSourceType
Необязательный параметр XlListObjectSourceType. Указывает тип источника для запроса. Может быть одной из следующих констант XlListObjectSourceType : xlSrcExternal или xlSrcRange. Если этот параметр опущен, значение SourceType по умолчанию будет значение xlSrcRange.
- Source
- Object
Необязательный параметр, если SourceType имеет значение xlSrcRange. Объект Range , представляющий источник данных. Если этот параметр опущен, Source по умолчанию будет использоваться диапазон, возвращаемый кодом обнаружения диапазона списка. Требуется, если SourceType имеет значение xlSrcExternal. Массив значений String , указывающих подключение к источнику. Element#Contents0URL для сайта SharePoint 1ListName 2ViewGUID
- LinkSource
- Object
Необязательный логический. Указывает, должен ли внешний источник данных быть связан с объектом ListObject . Если SourceType имеет значение xlSrcExternal, значение по умолчанию — True. Недопустимо, если SourceType имеет значение xlSrcRange, и возвращает ошибку, если она не опущена.
- XlListObjectHasHeaders
- XlYesNoGuess
Необязательный объект. Константы XlYesNoGuess , указывающие, имеют ли импортируемые данные метки столбцов. Если источник не содержит заголовки, Excel автоматически создаст заголовки.
- Destination
- Object
Необязательный объект. Объект Range , указывающий ссылку на одну ячейку в качестве назначения для левого верхнего угла нового объекта списка. Если объект Range ссылается на несколько ячеек, возникает ошибка. Аргумент Destination должен быть указан, если SourceType задано значение xlSrcExternal. Аргумент Destination игнорируется, если SourceType задано значение xlSrcRange. Диапазон назначения должен находиться на листе, который содержит указанную ListObjects коллекцию. Новые столбцы будут вставлены в , Destination чтобы соответствовать новому списку. Таким образом, существующие данные не будут перезаписаны.
Возвращаемое значение
Комментарии
Если список содержит заголовки, первая строка ячеек будет преобразована в текст, если еще не задано значение text. Преобразование будет основано на видимом тексте ячейки. Это означает, что если имеется значение даты с форматом даты , изменяющимся с языковым стандартом, преобразование в список может привести к разным результатам в зависимости от текущего языкового стандарта системы. Кроме того, если в строке заголовка есть две ячейки с одинаковым видимым текстом, будет добавлено добавочное целое число , чтобы сделать каждый заголовок столбца уникальным.