Méthode Workbooks.OpenText (Excel)

Charge et analyse un fichier texte comme un nouveau classeur d'une seule feuille contenant des données d'un fichier texte analysé.

Syntaxe

expression.OpenText (FileName, Origine, StartRow, DataType, TextQualifier, ConsecutiveDelimiter, Onglet, Point-virgule, Virgule, Espace, Autre, OtherChar, FieldInfo, TextVisualLayout, DecimalSeparator, ThousandsSeparator, TrailingMinusNumbers, Local)

expression Variable qui représente un objet Workbooks.

Paramètres

Nom	Requis/Facultatif	Type de données	Description
FileName	Obligatoire	String	Spécifie le nom du fichier texte à ouvrir et analyser.
Origin	Facultatif	Variant	Origine du fichier texte. Il peut s'agir de l’une des constantes XlPlatform suivantes : XlMacintosh, XlWindows ou XlMSDOS. Il peut également s'agir d'un nombre entier représentant le numéro de la page de code souhaitée. Par exemple, « 1256 » spécifie que le codage du fichier texte source est arabe (Windows). Si cet argument n’est pas spécifié, la méthode utilise le paramètre actuel de l’option Origine du fichier dans l’Assistant Importation de texte.
StartRow	Facultatif	Variant	Numéro de la ligne à partir de laquelle commencer l'analyse du texte. La valeur par défaut est 1.
DataType	Facultatif	Variant	Format de colonne des données dans le fichier. Il peut s’agir de l’une des constantes XlTextParsingType suivantes : xlDelimited ou xlFixedWidth. Si cet argument n'est pas spécifié, Microsoft Excel tente de déterminer le format de colonne lors de l'ouverture du fichier.
TextQualifier	Facultatif	XlTextQualifier	Spécifie l'identificateur de texte.
ConsecutiveDelimiter	Facultatif	Variant	True pour que des délimiteurs identiques consécutifs soient considérés comme un seul délimiteur. La valeur par défaut est False.
Tab	Facultatif	Variant	True pour que le caractère de tabulation serve de délimiteur (la propriété DataType doit être définie sur xlDelimited). La valeur par défaut est False.
Semicolon	Facultatif	Variant	True pour que le caractère point-virgule serve de délimiteur (la propriété DataType doit être définie sur xlDelimited). La valeur par défaut est False.
Comma	Facultatif	Variant	True pour que le caractère virgule serve de délimiteur (la propriété DataType doit être définie sur xlDelimited). La valeur par défaut est False.
Space	Facultatif	Variant	True pour que le caractère espace serve de délimiteur (la propriété DataType doit être définie sur xlDelimited). La valeur par défaut est False.
Other	Facultatif	Variant	True pour que le caractère spécifié par l’argument OtherChar serve de délimiteur (la propriété DataType doit être définie sur xlDelimited). La valeur par défaut est False.
OtherChar	Facultatif	Variant	Obligatoire si Autre a la valeur True. Spécifie le caractère de délimitation quand Autre a la valeur True. Si plusieurs caractères sont spécifiés, seul le premier caractère de la chaîne est utilisé ; les autres caractères sont ignorés.
FieldInfo	Facultatif	Variant	Matrice contenant des informations d'analyse pour les différentes colonnes de données. L’interprétation dépend de la valeur de DataType. Lorsque les données sont délimitées, cet argument est un tableau de tableaux à deux éléments, spécifiant les options de conversion pour une colonne particulière. Le premier élément est le numéro de colonne (en base 1), et le second est l’une des constantes XlColumnDataType spécifiant la manière dont la colonne est analysée.
TextVisualLayout	Facultatif	Variant	Mise en page visuelle du texte.
DecimalSeparator	Facultatif	Variante	Séparateur des milliers utilisé par Microsoft Excel lors de la reconnaissance des nombres. Le paramètre par défaut est le paramètre du système.
ThousandsSeparator	Facultatif	Variante	Séparateur décimal utilisé par Microsoft Excel lors de la reconnaissance des nombres. Le paramètre par défaut est le paramètre du système.
TrailingMinusNumbers	Facultatif	Variant	Spécifiez True si les nombres suivis du signe moins doivent être traités comme des nombres négatifs. Si la valeur est False ou omise, les nombres suivis du signe moins sont traités comme du texte.
Local	Facultatif	Variant	Spécifiez True si les paramètres régionaux de l’ordinateur doivent être utilisés pour les séparateurs, les nombres et la mise en forme des données.

Remarques

Paramètre FieldInfo

Utilisez le paramètre xlEMDFormat uniquement si vous avez installé et sélectionné la prise en charge linguistique taïwanaise. La constante xlEMDFormat spécifie que les dates d'ères chinoises (Taiwan) sont utilisées.

Les séparateurs de colonne peuvent être définis dans n'importe quel ordre. À défaut de spécificateur pour une colonne dans les données d'entrée, la colonne est analysée à l'aide du paramétrage général.

Dans cet exemple, la troisième colonne est analysée comme MJA (par exemple, 01/15/1970), la première comme texte, et les autres colonnes des données sources à l'aide du paramétrage général.

Array(Array(3, 3), Array(1, 2))

Si les données sources comportent des colonnes de largeur fixe, le premier élément de chaque matrice de deux éléments spécifie la position du caractère de début dans la colonne (comme nombre entier, le caractère 0 (zéro) étant le premier). Le second élément de la matrice définit l'option d'analyse de la colonne comme un chiffre compris entre 0 et 9 (inclus), comme illustré dans le tableau précédent.

Paramètre ThousandsSeparator

Le tableau suivant contient les résultats de l'importation de texte dans Excel pour divers paramètres d'importation. Les résultats numériques sont affichés dans la colonne la plus à droite.

Séparateur décimal système	Séparateur des milliers système	Valeur de séparateur décimal	Valeur de séparateur des milliers	Texte importé	Valeur de la cellule (type de données)
Period	Virgule	Virgule	Point	123.123,45	123,123.45 (numérique)
Point	Virgule	Virgule	Virgule	123.123,45	123.123,45 (texte)
Virgule	Period	Period	Virgule	123.123,45	123,123.45 (numérique)
Point	Virgule	Point	Virgule	123.123,45	123 123.45 (texte)
Point	Virgule	Point	Espace	123.123,45	123,123.45 (numérique)

Exemple

Cet exemple ouvre le fichier Data.txt et utilise les délimiteurs tabulations pour analyser le fichier texte dans une feuille de calcul.

Workbooks.OpenText filename:="DATA.TXT", _ 
    dataType:=xlDelimited, tab:=True

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.