NamedRange.TextToColumns Méthode

Définition

Espace de noms:

Microsoft.Office.Tools.Excel

Assembly:

Microsoft.Office.Tools.Excel.dll

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) xlTextQualifierNonexlTextQualifierSingleQuote

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 :xlMDYFormatxlDMYFormatxlYMDFormatxlMYDFormatxlTextFormatxlGeneralFormatxlYDMFormatxlEMDFormatxlDYMFormatxlSkipColumn 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.