XmlMappedRange.TextToColumns Metoda

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Excel

Zestaw:

Microsoft.Office.Tools.Excel.dll

Analizuje kolumnę komórek zawierających tekst w kilku kolumnach.

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

Parametry

Destination

Object

Element Range określający miejsce, w którym program Microsoft Office Excel umieszcza wyniki. Jeśli zakres jest większy niż pojedyncza komórka, używana jest lewa górna komórka.

DataType

XlTextParsingType

Format tekstu, który ma być podzielony na kolumny. Może być jedną z następujących XlTextParsingType stałych: xlDelimited (wartość domyślna) xlFixedWidth

TextQualifier

XlTextQualifier

Może być jedną z następujących XlTextQualifier wartości: xlTextQualifierDoubleQuote (wartość domyślna) xlTextQualifierNonexlTextQualifierSingleQuote

ConsecutiveDelimiter

Object

true aby program Excel rozważał kolejne ograniczniki jako jeden ogranicznik. Wartość domyślna to false.

Tab

Object

trueDataType musi mieć xlDelimited znak tabulacji i być ogranicznikiem. Wartość domyślna to false.

Semicolon

Object

trueDataType być i xlDelimited mieć średnik być ogranicznikiem. Wartość domyślna to false.

Comma

Object

trueDataTypexlDelimited być i mieć przecinek być ogranicznikiem. Wartość domyślna to false.

Space

Object

trueDataType musi być xlDelimited i mieć znak spacji być ogranicznikiem. Wartość domyślna to false.

Other

Object

trueDataType musi być xlDelimited i mieć znak określony przez OtherChar argument jako ogranicznik. Wartość domyślna to false.

OtherChar

Object

Znak ogranicznika, gdy Other ma wartość true. Jeśli określono więcej niż jeden znak, używany jest tylko pierwszy znak ciągu; pozostałe znaki są ignorowane.

FieldInfo

Object

Tablica zawierająca informacje analizy poszczególnych kolumn danych. Interpretacja zależy od wartości DataType. Gdy dane są rozdzielane, ten argument jest tablicą tablic dwuelementowych, z każdą tablicą dwuelementową określającą opcje konwersji dla określonej kolumny. Pierwszy element to numer kolumny (oparty na 1), a drugi element jest jedną z XlColumnDataType stałych określających sposób analizowania kolumny. Może być jedną z następujących XlColumnDataType wartości: można użyć xlEMDFormat tylko wtedy,xlTextFormatxlYDMFormatxlEMDFormatxlGeneralFormatxlDMYFormatxlSkipColumnxlMDYFormatxlYMDFormatxlMYDFormatxlDYMFormat gdy jest zainstalowana i wybrana obsługa języka tajwańskiego. xlEMDFormat określa, że są używane daty epoki tajwańskiej. Specyfikatory kolumn mogą być w dowolnej kolejności. Jeśli dany specyfikator kolumny nie jest obecny dla określonej kolumny w danych wejściowych, kolumna jest analizowana z ustawieniem xlGeneralFormat . Jeśli dane źródłowe mają kolumny o stałej szerokości, pierwszy element każdej tablicy dwuelementowej określa pozycję znaku początkowego w kolumnie (jako liczba całkowita; 0 (zero) jest pierwszym znakiem. Drugi element tablicy dwuelementowej określa opcję analizy kolumny jako liczbę z zakresu od 1 do 9, jak pokazano powyżej.

DecimalSeparator

Object

Separator dziesiętny używany przez program Excel podczas rozpoznawania liczb. Ustawieniem domyślnym jest ustawienie systemu.

ThousandsSeparator

Object

Separator tysięcy używany przez program Excel podczas rozpoznawania liczb. Ustawieniem domyślnym jest ustawienie systemu.

TrailingMinusNumbers

Object

Liczby rozpoczynające się od znaku minus.

Zwraca

Object

Przykłady

W poniższym przykładzie kodu użyto TextToColumns metody , aby przekonwertować ciąg daty rozdzielanej spacją w ciągu XmlMappedRange na trzy kolumny. W tym przykładzie kodu przyjęto założenie, że bieżący arkusz zawiera XmlMappedRange nazwę CustomerLastNameCell.

private void ConvertTextToColumns()
{
    this.CustomerDateCell.Value2 = "01 01 2001";
    Excel.Range destinationRange = this.Range["A5"];

    this.CustomerDateCell.TextToColumns(destinationRange, 
        Excel.XlTextParsingType.xlDelimited,
        Excel.XlTextQualifier.xlTextQualifierDoubleQuote);
}

Private Sub ConvertTextToColumns()
    Me.CustomerDateCell.Value2 = "01 01 2001"
    Dim destinationRange As Excel.Range = Me.Range("A5")

    Me.CustomerDateCell.TextToColumns(destinationRange, _
        Excel.XlTextParsingType.xlDelimited, _
        Excel.XlTextQualifier.xlTextQualifierDoubleQuote, Space:=True)
End Sub

Uwagi

W poniższej tabeli przedstawiono wyniki importowania tekstu do programu Excel dla różnych ustawień importu. Wyniki liczbowe są wyświetlane w najbardziej prawej kolumnie.

Separator dziesiętny systemu	Separator tysięcy systemu	Wartość separatora dziesiętnego	Wartość separatora tysięcy	Oryginalny tekst	Wartość komórki (typ danych)
Okres	Przecinek	Przecinek	Okres	123.123,45	123.123,45 (liczbowo)
Okres	Przecinek	Przecinek	Przecinek	123.123,45	123.123,45 (tekst)
Przecinek	Okres	Przecinek	Okres	123,123.45	123.123,45 (liczbowo)
Okres	Przecinek	Okres	Przecinek	123 123.45	123 123.45 (tekst)
Okres	Przecinek	Okres	Miejsce	123 123.45	123.123,45 (liczbowo)

Parametry opcjonalne

Aby uzyskać informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach pakietu Office.