ListObjects.Add Méthode

Définition

Espace de noms:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Cette méthode crée un nouvel objet Liste. Retourne un ListObject objet .

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

Paramètres

SourceType

XlListObjectSourceType

XlListObjectSourceType facultatif. Indique le type de source pour la requête. Il peut s’agir de l’une des constantes XlListObjectSourceType suivantes : xlSrcExternal ou xlSrcRange. En cas d’omission, la SourceType valeur par défaut est xlSrcRange.

Source

Object

Facultatif quand SourceType est xlSrcRange. Objet Range représentant la source de données. S’il est omis, la Source valeur par défaut est la plage retournée par le code de détection de plage de liste. Obligatoire quand SourceType est xlSrcExternal. Tableau de valeurs string spécifiant une connexion à la source. Element#Contents0URL to SharePoint site 1ListName 2ViewGUID

LinkSource

Object

Facultatif Boolean. Indique si une source de données externe doit être liée à l'objet ListObject. Si SourceType est xlSrcExternal, la valeur par défaut est True. Non valide si SourceType est xlSrcRange et retourne une erreur s’il n’est pas omis.

XlListObjectHasHeaders

XlYesNoGuess

Objet facultatif. Constante XlYesNoGuess qui indique si les données importées ont des étiquettes de colonne. Si la Source ne contient pas d'en-têtes, Excel les génère automatiquement.

Destination

Object

Objet facultatif. Objet Plage spécifiant une référence de cellule unique en tant que destination pour l'angle supérieur gauche du nouvel objet de liste. Si l’objet Range fait référence à plusieurs cellules, une erreur est générée. L’argument Destination doit être spécifié lorsque SourceType est défini sur xlSrcExternal. L’argument Destination est ignoré si SourceType est défini sur xlSrcRange. La plage de destination doit se trouver dans la feuille de calcul qui contient la collection spécifiée ListObjects . Les nouvelles colonnes seront insérées au niveau de pour Destination s’adapter à la nouvelle liste. Par conséquent, les données existantes ne sont pas supprimées.

Retours

ListObject

Remarques

Si la liste comporte des en-têtes, la première ligne de cellules est convertie en Texte si ce n’est pas déjà le cas. Cette conversion est basée sur le texte visible pour la cellule. Cela signifie que, si une valeur de date avec un format Date est modifiée par les paramètres régionaux, la conversion en liste peut produire des résultats différents selon les paramètres régionaux du système. De plus, si deux cellules de la ligne d’en-têtes contiennent le même texte, un Entier incrémentiel y est ajouté de façon à ce que chaque en-tête soit unique.