Udostępnij za pośrednictwem


XmlMappedRange.TextToColumns Metoda

Definicja

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

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.

Dotyczy