NamedRange.TextToColumns-Methode

Artikel
08/10/2011

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

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
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

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
)

Parameter

Destination
Typ: System.Object
Ein Microsoft.Office.Interop.Excel.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
Typ: Microsoft.Office.Interop.Excel.XlTextParsingType
Das Format des in Spalten aufzuteilenden Texts.
Kann eine der folgenden XlTextParsingType-Konstanten sein:
xlDelimited (Standardwert)
xlFixedWidth

TextQualifier
Typ: Microsoft.Office.Interop.Excel.XlTextQualifier
Kann einer der folgenden XlTextQualifier-Werte sein:
xlTextQualifierDoubleQuote (Standardwert)
xlTextQualifierNone
xlTextQualifierSingleQuote

ConsecutiveDelimiter
Typ: System.Object
true, damit Excel aufeinander folgende Trennzeichen als ein Trennzeichen betrachtet.Der Standardwert ist false.

Tab
Typ: System.Object
true, wenn DataTypexlDelimited sein soll und das Tabstoppzeichen als Trennzeichen angesehen werden soll.Der Standardwert ist false.

Semicolon
Typ: System.Object
true, wenn DataTypexlDelimited sein soll und das Semikolon als Trennzeichen angesehen werden soll.Der Standardwert ist false.

Comma
Typ: System.Object
true, wenn DataTypexlDelimited sein soll und das Komma als Trennzeichen angesehen werden soll.Der Standardwert ist false.

Space
Typ: System.Object
true, wenn DataTypexlDelimited sein soll und das Leerzeichen als Trennzeichen angesehen werden soll.Der Standardwert ist false.

Other
Typ: System.Object
true, wenn DataTypexlDelimited sein soll und das durch das OtherChar-Argument angegebene Zeichen als Trennzeichen angesehen werden soll.Der Standardwert ist false.

OtherChar
Typ: System.Object
Das Trennzeichen, wenn Othertrue ist.Wenn mehr als ein Zeichen angegeben ist, wird nur das erste Zeichen der Zeichenfolge verwendet. Die restlichen Zeichen werden ignoriert.

FieldInfo
Typ: System.Object
Ein Array, das Analyseinformationen für die einzelnen Datenspalten enthält.Die Interpretation ist vom Wert des 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:
xlGeneralFormat
xlTextFormat
xlMDYFormat
xlDMYFormat
xlYMDFormat
xlMYDFormat
xlDYMFormat
xlYDMFormat
xlEMDFormat
xlSkipColumn
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
Typ: System.Object
Das Dezimaltrennzeichen, das Excel beim Erkennen von Zahlen verwendet.Die Standardeinstellung ist die Systemeinstellung.

ThousandsSeparator
Typ: System.Object
Das Tausendertrennzeichen, das Excel beim Erkennen von Zahlen verwendet.Die Standardeinstellung ist die Systemeinstellung.

TrailingMinusNumbers
Typ: System.Object
Zahlen mit vorangestelltem Minuszeichen.

Rückgabewert

Typ: System.Object

Hinweise

In der folgenden Tabelle werden die Ergebnisse für den Textimport in Excel für verschiedene Importeinstellungen angezeigt. Numerische Ergebnisse werden in der am weitesten rechts stehenden Spalte angezeigt.

Systemdezimaltrennzeichen	Systemtausendertrennzeichen	Dezimaltrennzeichenwert	Tausendertrennzeichenwert	Ursprünglicher Text	Zellenwert (Datentyp)
Period	Komma	Komma	Period	123.123,45	123,123.45 (numerisch)
Period	Komma	Komma	Komma	123.123,45	123.123,45 (Text)
Komma	Period	Komma	Period	123,123.45	123,123.45 (numerisch)
Period	Komma	Period	Komma	123 123.45	123.123,45 (Text)
Period	Komma	Period	Leerzeichen	123 123.45	123,123.45 (numerisch)

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird mithilfe der TextToColumns-Methode eine durch Leerzeichen getrennte Datumszeichenfolge in einem NamedRange in drei Spalten konvertiert.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    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

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

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

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace