ListObjects.Add Método

Esta página é útil?

Algum comentário adicional?

Os comentários serão enviados à Microsoft: quando você pressionar o botão Enviar, seus comentários serão usados para aprimorar os produtos e os serviços da Microsoft. Política de Privacidade.

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

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 ListObject

Parâmetros

SourceType

XlListObjectSourceType

Opcional XlListObjectSourceType. Indica o tipo de fonte da consulta. Pode ser uma das seguintes constantes XlListObjectSourceType: xlSrcExternal ou xlSrcRange. Se omitido, SourceType o padrão será xlSrcRange.

Source

Object

Opcional quando SourceType é xlSrcRange. Um Range objeto que representa a fonte de dados. Se omitido, o padrão será o intervalo retornado pelo código de detecção Source de intervalo de lista. Obrigatório quando SourceType for xlSrcExternal. Uma matriz de valores String especificando uma conexão com a fonte. Elemento#Contents0URL para SharePoint site 1ListName 2ViewGUID

LinkSource

Object

Opcional Boolean. 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 xlSrcRangee retornará um erro se não for omitido.

XlListObjectHasHeaders

XlYesNoGuess

Objeto Opcional. Uma XlYesNoGuess constante que indica se os dados que estão sendo 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 do 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 estiver definido como SourceType xlSrcExternal. O Destination argumento será ignorado se estiver definido como SourceType xlSrcRange. O intervalo de destino deve estar na planilha que contém a coleção ListObjects especificada. Novas colunas serão inseridas no Destination para caber na nova lista. Portanto, os dados existentes não serão substituídos.

Retornos

ListObject

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.