NamedRange.TextToColumns(Object, XlTextParsingType, XlTextQualifier, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) Methode

Definition

Analysiert eine Spalte von Zellen mit Text, der sich über mehrere Spalten erstreckt.

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

Parameter

Destination
Object

Ein Range-Objekt, das angibt, an welcher Position Microsoft Office Excel die Ergebnisse einfügen soll. Wenn der Bereich größer als eine einzelne Zelle ist, wird die linke oberste Zelle verwendet.

DataType
XlTextParsingType

Das Format des in Spalten aufzuteilenden Texts.

Kann eine der folgenden XlTextParsingType-Konstanten sein: xlDelimited (Standardwert) xlFixedWidth

TextQualifier
XlTextQualifier

Kann einer der folgenden XlTextQualifier-Werte sein: xlTextQualifierDoubleQuote (Standardwert) xlTextQualifierNonexlTextQualifierSingleQuote

ConsecutiveDelimiter
Object

true, damit Excel aufeinander folgende Trennzeichen als ein Trennzeichen betrachtet. Der Standardwert ist false.

Tab
Object

true, wenn DataType xlDelimited sein soll und das Tabstoppzeichen als Trennzeichen angesehen werden soll. Der Standardwert ist false.

Semicolon
Object

true, wenn DataType xlDelimited sein soll und das Semikolon als Trennzeichen angesehen werden soll. Der Standardwert ist false.

Comma
Object

true, wenn DataType xlDelimited sein soll und das Komma als Trennzeichen angesehen werden soll. Der Standardwert ist false.

Space
Object

true, wenn DataType xlDelimited sein soll und das Leerzeichen als Trennzeichen angesehen werden soll. Der Standardwert ist false.

Other
Object

true, wenn DataType xlDelimited sein soll und das durch das OtherChar-Argument angegebene Zeichen als Trennzeichen angesehen werden soll. Der Standardwert ist false.

OtherChar
Object

Das Trennzeichen, wenn Other true ist. Wenn mehr als ein Zeichen angegeben ist, wird nur das erste Zeichen der Zeichenfolge verwendet. Die restlichen Zeichen werden ignoriert.

FieldInfo
Object

Ein Array, das Analyseinformationen für die einzelnen Datenspalten enthält. Die Interpretation ist vom Wert von DataType abhängig. Wenn die Daten durch Trennzeichen getrennt sind, ist das Argument ein Array von Arrays mit zwei Elementen. Dabei gibt jedes Array mit zwei Elementen die Konvertierungsoptionen für eine bestimmte Spalte an. Das erste Element ist die Spaltennummer (1-basiert), und das zweite Element ist eine der XlColumnDataType-Konstanten, die angeben, wie die Spalte analysiert wird.

Kann einer der folgenden XlColumnDataType-Werte sein: xlGeneralFormatxlTextFormatxlMDYFormatxlDMYFormatxlYMDFormatxlMYDFormatxlDYMFormatxlYDMFormatxlEMDFormatxlSkipColumn

Sie können xlEMDFormat nur dann verwenden, wenn die Sprachunterstützung für Taiwanesisch installiert und ausgewählt ist. xlEMDFormat gibt an, dass taiwanesische Datumsangaben verwendet werden.

Die Spaltenspezifizierer können in beliebiger Reihenfolge angeordnet sein. Wenn ein angegebener Spaltenspezifizierer für eine bestimmte Spalten in den Eingabedaten nicht vorhanden ist, wird die Spalte mit der Einstellung xlGeneralFormat analyisiert.

Wenn die Spalten der Quelldaten eine feste Breite haben, gibt das erste Element eines Arrays mit zwei Elementen die Position des ersten Zeichens in der Spalte an (als ganze Zahl; 0 (null) ist das erste Zeichen). Das zweite Element des Arrays mit zwei Elementen gibt die Analyseoption für die Spalte als Zahl von 1 bis 9 an, wie oben angegeben.

DecimalSeparator
Object

Das Dezimaltrennzeichen, das Excel beim Erkennen von Zahlen verwendet. Die Standardeinstellung ist die Systemeinstellung.

ThousandsSeparator
Object

Das Tausendertrennzeichen, das Excel beim Erkennen von Zahlen verwendet. Die Standardeinstellung ist die Systemeinstellung.

TrailingMinusNumbers
Object

Zahlen mit vorangestelltem Minuszeichen.

Gibt zurück

Object

Beispiele

Im folgenden Codebeispiel wird die TextToColumns -Methode verwendet, um eine durch Leerzeichen getrennte Datums Zeichenfolge in einem in NamedRange drei Spalten zu konvertieren.

Dieses Beispiel gilt für eine Anpassung auf Dokument Ebene.

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

Hinweise

In der folgenden Tabelle werden die Ergebnisse des Importierens von Text in Excel für verschiedene Import Einstellungen angezeigt. Numerische Ergebnisse werden in der Spalte ganz rechts angezeigt.

Dezimaltrennzeichen für System System Tausender Trennzeichen Dezimaltrennzeichen Wert Tausender Trennzeichen Wert Ursprünglicher Text Zellwert (Datentyp)
Zeitraum Komma Komma Zeitraum 123.123,45 123.123,45 (numerisch)
Zeitraum Komma Komma Komma 123.123,45 123.123, 45 (Text)
Komma Zeitraum Komma Zeitraum 123,123.45 123.123,45 (numerisch)
Zeitraum Komma Zeitraum Komma 123 123.45 123.123,45 (Text)
Zeitraum Komma Zeitraum Leerzeichen 123 123.45 123.123,45 (numerisch)

Optionale Parameter

Weitere Informationen zu optionalen Parametern finden Sie unter optionale Parameter in Office-Projektmappen.

Gilt für