NamedRange.TextToColumns Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

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.

Analyse une colonne des cellules qui contiennent du texte en plusieurs colonnes.

public object TextToColumns (object Destination, Microsoft.Office.Interop.Excel.XlTextParsingType DataType = Microsoft.Office.Interop.Excel.XlTextParsingType.xlDelimited, Microsoft.Office.Interop.Excel.XlTextQualifier TextQualifier = Microsoft.Office.Interop.Excel.XlTextQualifier.xlTextQualifierDoubleQuote, object ConsecutiveDelimiter, object Tab, object Semicolon, object Comma, object Space, object Other, object OtherChar, object FieldInfo, object DecimalSeparator, object ThousandsSeparator, object TrailingMinusNumbers);

abstract member TextToColumns : obj * Microsoft.Office.Interop.Excel.XlTextParsingType * Microsoft.Office.Interop.Excel.XlTextQualifier * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> obj

Public Function TextToColumns (Optional Destination As Object, Optional DataType As XlTextParsingType = Microsoft.Office.Interop.Excel.XlTextParsingType.xlDelimited, Optional TextQualifier As XlTextQualifier = Microsoft.Office.Interop.Excel.XlTextQualifier.xlTextQualifierDoubleQuote, Optional ConsecutiveDelimiter As Object, Optional Tab As Object, Optional Semicolon As Object, Optional Comma As Object, Optional Space As Object, Optional Other As Object, Optional OtherChar As Object, Optional FieldInfo As Object, Optional DecimalSeparator As Object, Optional ThousandsSeparator As Object, Optional TrailingMinusNumbers As Object) As Object

Paramètres

Destination: Object

Objet Range qui indique l'emplacement où Microsoft Office Excel placera les résultats. Si la plage est plus grande qu'une seule cellule, la cellule supérieure gauche est utilisée.

DataType: XlTextParsingType

Format du texte à fractionner en colonnes. Il peut s’agir de l’une des constantes suivantes XlTextParsingType : xlDelimited (valeur par défaut) xlFixedWidth

TextQualifier: XlTextQualifier

Il peut s’agir de l’une des valeurs suivantes XlTextQualifier : xlTextQualifierDoubleQuote (valeur par défaut) xlTextQualifierNone xlTextQualifierSingleQuote

ConsecutiveDelimiter: Object

true pour que Microsoft Office Excel considère des séparateurs consécutifs comme un seul séparateur. La valeur par défaut est false.

Tab: Object

true pour que DataTypexlDelimited le caractère de tabulation soit un délimiteur. La valeur par défaut est false.

Semicolon: Object

true pour que DataTypexlDelimited le point-virgule soit un délimiteur. La valeur par défaut est false.

Comma: Object

true pour que DataType la virgule soit xlDelimited un délimiteur. La valeur par défaut est false.

Space: Object

true pour que DataTypexlDelimited le caractère d’espace soit un délimiteur. La valeur par défaut est false.

Other: Object

true pour que DataTypexlDelimited le caractère spécifié par l’argument OtherChar soit un délimiteur. La valeur par défaut est false.

OtherChar: Object

Caractère délimiteur lorsque Other est 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: Object

Tableau contenant les informations d'analyse 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 de deux éléments, chaque tableau de deux éléments spécifiant les options de conversion d'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 XlColumnDataType des constantes spécifiant la façon dont la colonne est analysée. Peut être l’une des valeurs suivantes XlColumnDataType :xlMDYFormat xlDMYFormat xlYMDFormat xlMYDFormat xlTextFormat xlGeneralFormat xlYDMFormat xlEMDFormat xlDYMFormat xlSkipColumn Vous pouvez utiliser xlEMDFormat uniquement si la prise en charge de la langue taïwanaise est installée et sélectionnée. xlEMDFormat spécifie que les dates de l’ère taïwanaise sont utilisées. Les spécificateurs de colonne peuvent être dans n’importe quel ordre. En l'absence d'un spécificateur de colonne donné pour une colonne particulière dans les données d'entrée, la colonne est analysée avec le paramètre xlGeneralFormat. Si les données sources ont des colonnes avec une largeur fixe, le premier élément de chaque tableau de deux éléments spécifie la position du caractère de départ dans la colonne (sous la forme d'un entier, 0 (zéro) étant le premier caractère). Le second élément du tableau de deux éléments spécifie l'option d'analyse pour la colonne sous la forme d'un chiffre compris entre 1 et 9, comme répertorié ci-dessus.

DecimalSeparator: Object

Séparateur décimal utilisé par Excel lors de la reconnaissance des nombres. Le paramètre par défaut est le paramètre système.

ThousandsSeparator: Object

Séparateur des milliers utilisé par Excel lors de la reconnaissance des nombres. Le paramètre par défaut est le paramètre système.

TrailingMinusNumbers: Object

Nombres qui commencent par un signe moins.

Retours

Object

Exemples

L’exemple de code suivant utilise la TextToColumns méthode pour convertir une chaîne de date délimitée par des espaces dans un NamedRange en trois colonnes.

Cet exemple concerne une personnalisation au niveau du document.

private void ConvertTextToColumns()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1"],
        "namedRange1");

    namedRange1.Value2 = "01 01 2001";
    Excel.Range destinationRange = this.Range["A5"];

    namedRange1.TextToColumns(destinationRange,
        Excel.XlTextParsingType.xlDelimited,
        Excel.XlTextQualifier.xlTextQualifierDoubleQuote,
         true);
}

Private Sub ConvertTextToColumns()
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1"), _
        "namedRange1")

    namedRange1.Value2 = "01 01 2001"
    Dim destinationRange As Excel.Range = Me.Range("A5")

    namedRange1.TextToColumns(destinationRange, _
        Excel.XlTextParsingType.xlDelimited, _
        Excel.XlTextQualifier.xlTextQualifierDoubleQuote, , , , , _
        True, , , , , , )
End Sub

Remarques

Le tableau suivant montre les résultats de l’importation de texte dans Excel pour différents 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 de milliers de systèmes	Valeur de séparateur décimal	Valeur de séparateur de milliers	Texte d’origine	Valeur de cellule (type de données)
Période	Comma	Comma	Période	123.123,45	123 123,45 (numérique)
Période	Comma	Comma	Comma	123.123,45	123.123,45 (texte)
Comma	Période	Comma	Période	123,123.45	123 123,45 (numérique)
Période	Comma	Période	Comma	123 123.45	123 123.45 (texte)
Période	Comma	Période	Espace	123 123.45	123 123,45 (numérique)

Paramètres facultatifs

Pour plus d’informations sur les paramètres facultatifs, consultez Paramètres facultatifs dans les solutions Office.

S’applique à