Méthode Range.TextToColumns (Excel)

Cette méthode redistribue sur plusieurs colonnes une colonne de cellules qui comportent du texte.

Syntaxe

expression. TextToColumns (Destination, DataType, TextQualifier, ConsecutiveDelimiter, Tab, Semicolon, Comma, Space, Other, OtherChar, FieldInfo, DecimalSeparator, ThousandsSeparator, TrailingMinusNumbers)

expression Variable représentant un objet Range.

Paramètres

Nom	Requis/Facultatif	Type de données	Description
Destination	Facultatif	Variant	Objet Range qui spécifie l’endroit où Microsoft Excel place les résultats. Si la plage contient plusieurs cellules, la cellule située dans le coin supérieur gauche est utilisée.
Type de données	Facultatif	XlTextParsingType	Format du texte à diviser en colonnes.
TextQualifier	Facultatif	XlTextQualifier	Spécifie s’il faut utiliser des guillemets simples, doubles ou sans guillemets comme qualificateur de texte.
ConsecutiveDelimiter	Facultatif	Variant	True pour qu’Excel considère les délimiteurs consécutifs comme un délimiteur. La valeur par défaut est False.
Tab	Facultatif	Variante	True pour que DataType ait la valeur xlDelimited et que la tabulation soit le séparateur. La valeur par défaut est False.
Semicolon	Facultatif	Variante	True pour que DataType ait la valeur xlDelimited et que le point-virgule soit le séparateur. La valeur par défaut est False.
Comma	Facultatif	Variante	True pour que DataType ait la valeur xlDelimited et que la virgule soit le séparateur. La valeur par défaut est False.
Space	Facultatif	Variante	True pour que DataType ait la valeur xlDelimited et que l'espace soit le séparateur. La valeur par défaut est False.
Other	Facultatif	Variante	True pour que DataType ait la valeur xlDelimited et que le caractère spécifié par l'argument OtherChar soit le séparateur. La valeur par défaut est False.
OtherChar	Facultatif	Variant	Obligatoire si Other a la valeur True ; caractère délimiteur lorsque Other 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	Variante	Tableau contenant des informations redistribuées pour des colonnes individuelles 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 (basé sur 1), et le deuxième élément est l’une des constantes XlColumnDataType spécifiant la façon dont la colonne est analysée.
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.
NombresNégatifsDeFin	Facultatif	Variant	Nombres qui commencent par un signe moins.

Valeur renvoyée

Variant

Remarques

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 d'origine	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	Point	Virgule	Point	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)

Utilisez la constante xlEMDFormat de l’énumération XlColumnDataType uniquement si la prise en charge de la langue taïwanaise est installée et sélectionnée. 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. Si, parmi les données d’une colonne, il manque un séparateur de colonne particulier, la colonne est redistribuée selon le paramètre xlGeneralFormat. Cet exemple montre comment faire en sorte que la troisième colonne soit ignorée, que la première soit redistribuée sous la forme de texte et que les colonnes restantes des données sources soient redistribuées selon le paramètre xlGeneralFormat.

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

Si les données sources sont composées de colonnes à largeur fixe, le premier élément de chaque tableau à deux éléments spécifie la position de départ du caractère dans la colonne (sous la forme d'un nombre entier ; le chiffre zéro (0) est le premier caractère). Le deuxième élément du tableau à deux éléments spécifie l’option d’analyse pour la colonne sous la forme d’un nombre compris entre 1 et 9, comme indiqué précédemment.

L'exemple suivant montre comment redistribuer deux colonnes à partir d'un fichier à largeur fixe. La première colonne commence au début de la ligne et s'étend sur 10 caractères, et la deuxième colonne commence à la position 15 et va jusqu'au bout de la ligne. Pour éviter d’inclure les caractères entre position 10 et 15, Microsoft Excel ajoute une entrée de colonne ignorée.

Array(Array(0, 1), Array(10, 9), Array(15, 1))

Exemple

Cet exemple convertit le contenu du Presse-papiers, lequel contient un tableau de texte séparé par des espaces, dans des colonnes distinctes dans Feuil1. Vous pouvez créer ce type de tableau dans le Bloc-notes ou WordPad (ou dans un autre éditeur de texte), copier le tableau de texte dans le Presse-papiers, basculer vers Microsoft Excel, puis exécuter cet exemple.

Worksheets("Sheet1").Activate 
ActiveSheet.Paste 
Selection.TextToColumns DataType:=xlDelimited, _ 
 ConsecutiveDelimiter:=True, Space:=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.