NamedRange.TextToColumns(Object, XlTextParsingType, XlTextQualifier, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.