NamedRange.TextToColumns Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Office.Tools.Excel

Zestaw:: Microsoft.Office.Tools.Excel.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Range Obiekt określający miejsce, w którym program Microsoft Office Excel umieści 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) xlTextQualifierNone xlTextQualifierSingleQuote

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,xlTextFormat xlYDMFormat xlEMDFormat xlGeneralFormat xlDMYFormat xlSkipColumn xlMDYFormat xlYMDFormat xlMYDFormat xlDYMFormat 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ć rozdzielany spacją ciąg daty w ciągu na NamedRange trzy kolumny.

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

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

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