ListObjects.Add Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Cette méthode crée un nouvel objet Liste. Renvoie 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 ListObjectParamètres
- SourceType
- XlListObjectSourceType
XlListObjectSourceType facultatif. Indique le type de source pour la requête. Peut être l’une des constantes XlListObjectSourceType suivantes : xlSrcExternal ou xlSrcRange. Si cette option est omise, la SourceType valeur par défaut est xlSrcRange.
- Source
- Object
Facultatif quand SourceType est xlSrcRange. Objet Range représentant la source de données. Si cette option est omise, la Source valeur par défaut est la plage renvoyée par le code de détection de plage de liste. Obligatoire lorsque SourceType est xlSrcExternal. Tableau de valeurs de chaîne spécifiant une connexion à la source. Element#Contents0URL vers le site SharePoint 1ListName 2ViewGUID
- LinkSource
- Object
Facultatif Boolean. Indique si une source de données externe doit être liée à l'objet ListObject. Si SourceType la valeur est xlSrcExternal, la valeur par défaut est True. Non valide si SourceType est xlSrcRange et renvoie une erreur si elle n’est pas omise.
- XlListObjectHasHeaders
- XlYesNoGuess
Objet facultatif. Constante XlYesNoGuess qui indique si les données importées comportent 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é quand SourceType est défini sur xlSrcExternal. L’argument Destination est ignoré si SourceType est défini sur xlSrcRange. La plage de destination doit figurer dans la feuille de calcul qui contient la collection spécifiée ListObjects . De nouvelles colonnes seront insérées pour s’adapter Destination à la nouvelle liste. Par conséquent, les données existantes ne sont pas supprimées.
Retours
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.