ListObjects.Add Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria um novo objeto de lista. Retorna um ListObject objeto.
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 ListObjectParâmetros
- SourceType
- XlListObjectSourceType
XlListObjectSourceType opcional. Indica o tipo de fonte da consulta. Pode ser uma das seguintes constantes XlListObjectSourceType : xlSrcExternal ou xlSrcRange. Se omitido, o SourceType padrão será xlSrcRange.
- Source
- Object
Opcional quando SourceType é xlSrcRange. Um Range objeto que representa a fonte de dados. Se omitido, o Source padrão será para o intervalo retornado pelo código de detecção de intervalo de listas. Necessário quando SourceType for xlSrcExternal. Uma matriz de valores string especificando uma conexão com a origem. Element#Contents0URL to SharePoint site 1ListName 2ViewGUID
- LinkSource
- Object
Booliano opcional. Indica se uma fonte de dados externa deve ser vinculada ao objeto ListObject. Se SourceType for xlSrcExternal, o padrão será True. Inválido se SourceType for xlSrcRange e retornará um erro se não for omitido.
- XlListObjectHasHeaders
- XlYesNoGuess
Objeto opcional. Uma XlYesNoGuess constante que indica se os dados importados têm rótulos de coluna. Quado o Source não tem cabeçalhos, o Excel os gera automaticamente.
- Destination
- Object
Objeto opcional. Um objeto Range especificando uma referência de célula única como o destino para o canto superior esquerdo do novo objeto list. Se o objeto Range se refere a mais de uma célula, um erro é gerado. O Destination argumento deve ser especificado quando SourceType é definido como xlSrcExternal. O Destination argumento será ignorado se SourceType estiver definido como xlSrcRange. O intervalo de destino deve estar na planilha que contém a coleção especificada ListObjects . Novas colunas serão inseridas no Destination para ajustar a nova lista. Portanto, os dados existentes não serão substituídos.
Retornos
Comentários
Quando a lista tiver cabeçalhos, a primeira linha de células será convertida em Text, se ainda não estiver definida como texto. A conversão será baseada no texto visível na célula. Isso significa que, se existir um valor de data com um formato Date que é alterado de acordo com o local, a conversão em uma lista poderá produzir resultados diferentes, dependendo do local do sistema atual. Além disso, se duas células na linha de cabeçalho contiverem o mesmo texto visível, será acrescentado um Integer incremental para tornar cada cabeçalho de coluna exclusivo.