XmlMappedRange.TextToColumns, méthode (System 2007)

Article
09/04/2008

Mise à jour : novembre 2007

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

Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel.v9.0 (dans Microsoft.Office.Tools.Excel.v9.0.dll)

Syntaxe

Public Function TextToColumns ( _
    Destination As Object, _
    DataType As XlTextParsingType, _
    TextQualifier As XlTextQualifier, _
    ConsecutiveDelimiter As Object, _
    Tab As Object, _
    Semicolon As Object, _
    Comma As Object, _
    Space As Object, _
    Other As Object, _
    OtherChar As Object, _
    FieldInfo As Object, _
    DecimalSeparator As Object, _
    ThousandsSeparator As Object, _
    TrailingMinusNumbers As Object _
) As Object

Dim instance As XmlMappedRange
Dim Destination As Object
Dim DataType As XlTextParsingType
Dim TextQualifier As XlTextQualifier
Dim ConsecutiveDelimiter As Object
Dim Tab As Object
Dim Semicolon As Object
Dim Comma As Object
Dim Space As Object
Dim Other As Object
Dim OtherChar As Object
Dim FieldInfo As Object
Dim DecimalSeparator As Object
Dim ThousandsSeparator As Object
Dim TrailingMinusNumbers As Object
Dim returnValue As Object

returnValue = instance.TextToColumns(Destination, _
    DataType, TextQualifier, ConsecutiveDelimiter, _
    Tab, Semicolon, Comma, Space, Other, _
    OtherChar, FieldInfo, DecimalSeparator, _
    ThousandsSeparator, TrailingMinusNumbers)

public Object TextToColumns(
    Object Destination,
    XlTextParsingType DataType,
    XlTextQualifier TextQualifier,
    Object ConsecutiveDelimiter,
    Object Tab,
    Object Semicolon,
    Object Comma,
    Object Space,
    Object Other,
    Object OtherChar,
    Object FieldInfo,
    Object DecimalSeparator,
    Object ThousandsSeparator,
    Object TrailingMinusNumbers
)

Paramètres

Destination
Type : System.Object

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

DataType
Type : Microsoft.Office.Interop.Excel.XlTextParsingType

Format du texte à répartir dans les colonnes.

Il peut s'agir de l'une des constantes XlTextParsingType suivantes :
- xlDelimited (par défaut)
- xlFixedWidth

TextQualifier
Type : Microsoft.Office.Interop.Excel.XlTextQualifier

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

ConsecutiveDelimiter
Type : System.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
Type : System.Object

true pour que DataType soit xlDelimited et le caractère de tabulation un séparateur. La valeur par défaut est false.

Semicolon
Type : System.Object

true pour que DataType soit xlDelimited et le point-virgule un séparateur. La valeur par défaut est false.

Comma
Type : System.Object

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

Space
Type : System.Object

true pour que DataType soit xlDelimited et l'espace un séparateur. La valeur par défaut est false.

Other
Type : System.Object

true pour que DataType soit xlDelimited et que le caractère spécifié par l'argument OtherChar soit un séparateur. La valeur par défaut est false.

OtherChar
Type : System.Object

Séparateur 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
Type : System.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 (en base 1) et le second l'une des constantes XlColumnDataType qui spécifient le mode d'analyse de la colonne.

Il peut s'agir de l'une des valeurs XlColumnDataType suivantes :
Vous pouvez utiliser xlEMDFormat uniquement si la prise en charge linguistique du chinois de Taïwan est installée et sélectionnée. xlEMDFormat indique que les dates du calendrier taïwanais sont utilisées.

L'ordre des spécificateurs de colonne n'a pas d'importance. 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
Type : System.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
Type : System.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
Type : System.Object

Nombres qui commencent par un signe moins.

Valeur de retour

Type : System.Object

Notes

Le tableau suivant affiche les résultats de l'importation de texte dans Excel pour plusieurs paramètres d'importation. Les résultats numériques sont affichés dans la colonne située à l'extrême droite.

Séparateur décimal du système	Séparateur des milliers du système	Valeur du séparateur décimal	Valeur du séparateur des milliers	Texte d'origine	Valeur de la cellule (type de données)
Point	Comma (virgule)	Comma (virgule)	Point	123.123,45	123,123.45 (numérique)
Point	Comma (virgule)	Comma (virgule)	Comma (virgule)	123.123,45	123.123,45 (texte)
Comma (virgule)	Point	Comma (virgule)	Point	123,123.45	123,123.45 (numérique)
Point	Comma (virgule)	Point	Comma (virgule)	123 123.45	123 123.45 (texte)
Point	Comma (virgule)	Point	Espace	123 123.45	123,123.45 (numérique)

Paramètres optionnels

Pour plus d'informations sur les paramètres optionnels, consultez Fonctionnement des paramètres optionnels dans les solutions Office.

Exemples

L'exemple de code suivant utilise la méthode TextToColumns pour convertir une chaîne de date délimitée par des espaces dans XmlMappedRange en trois colonnes. Cet exemple de code suppose que la feuille de calcul active contient un contrôle XmlMappedRange nommé CustomerLastNameCell.

Private Sub ConvertTextToColumns()
    Me.CustomerDateCell.Value2 = "01 01 2001"
    Dim destinationRange As Excel.Range = Me.Range("A5")

    Me.CustomerDateCell.TextToColumns(destinationRange, _
        Excel.XlTextParsingType.xlDelimited, _
        Excel.XlTextQualifier.xlTextQualifierDoubleQuote, Space:=True)
End Sub

private void ConvertTextToColumns()
{
    this.CustomerDateCell.Value2 = "01 01 2001";
    Excel.Range destinationRange = this.Range["A5", missing];

    this.CustomerDateCell.TextToColumns(destinationRange, 
        Excel.XlTextParsingType.xlDelimited,
        Excel.XlTextQualifier.xlTextQualifierDoubleQuote, missing,
        missing, missing, missing, true, missing, missing, missing, 
        missing, missing, missing);
}

Autorisations

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

XmlMappedRange, classe

Membres XmlMappedRange

Microsoft.Office.Tools.Excel, espace de noms