NamedRange.TextToColumns Methode

Definition

Namespace:

Microsoft.Office.Tools.Excel

Assembly:

Microsoft.Office.Tools.Excel.dll

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

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

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 Texts, der in Spalten unterteilt werden soll. Kann eine der folgenden XlTextParsingType Konstanten sein: xlDelimited (Standard) xlFixedWidth

TextQualifier

XlTextQualifier

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

ConsecutiveDelimiter

Object

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

Tab

Object

true , um zu sein DataTypexlDelimited und zu haben, dass das Registerkartenzeichen ein Trennzeichen ist. Standardwert: false.

Semicolon

Object

true , dass das Semikolon ein Trennzeichen sein soll DataTypexlDelimited . Standardwert: false.

Comma

Object

true , dass das Komma ein Trennzeichen sein soll DataTypexlDelimited . Standardwert: false.

Space

Object

true , dass das Leerzeichen ein Trennzeichen sein soll DataTypexlDelimited . Standardwert: false.

Other

Object

true, dass das durch das OtherChar Argument angegebene Zeichen ein Trennzeichen sein xlDelimited sollDataType. Standardwert: false.

OtherChar

Object

Das Trennzeichen, wenn Other ist true. 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 hängt vom Wert von ab DataType. 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 Konstanten, die XlColumnDataType angeben, wie die Spalte analysiert wird. Kann einer der folgenden XlColumnDataType Werte sein:xlTextFormatxlDMYFormatxlYMDFormatxlMYDFormatxlMDYFormatxlGeneralFormatxlYDMFormatxlEMDFormatxlDYMFormatxlSkipColumn Sie können nur verwendenxlEMDFormat, wenn die Taiwanesische Sprachunterstützung installiert und ausgewählt ist. xlEMDFormat gibt an, dass datumsangaben aus der taiwanesischen Ära verwendet werden. Die Spaltenbezeichner können in beliebiger Reihenfolge angegeben werden. 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 Datumszeichenfolge in drei NamedRange Spalten zu konvertieren.

Dieses Beispiel gilt für eine Anpassung auf Dokumentebene.

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

Die folgende Tabelle zeigt die Ergebnisse des Importierens von Text in Excel für verschiedene Importeinstellungen. Numerische Ergebnisse werden in der spalte rechts angezeigt.

Systemdezimaltrennzeichen	Systemtausendertrennzeichen	Dezimaltrennzeichenwert	Tausendertrennzeichenwert	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	LeerZchn	123 123.45	123.123,45 (numerisch)

Optionale Parameter

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