NamedRange.TextToColumns-Methode

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.

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"],
        "namedRange1");

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

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

.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