Metoda NamedRange.TextToColumns —

Artykuł
01/08/2014

Analizuje kolumny komórek, które zawierają tekst w kilku kolumnach.

Przestrzeń nazw: Microsoft.Office.Tools.Excel
Zestaw: Microsoft.Office.Tools.Excel (w Microsoft.Office.Tools.Excel.dll)

Składnia

'Deklaracja
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
)

Parametry

Destination
Typ: System.Object
A Microsoft.Office.Interop.Excel.Range obiekt, który określa, w którym program Microsoft Office Excel spowoduje umieszczenie wyników.Jeśli zakres jest większy niż pojedynczą komórkę, lewą górną komórkę jest używany.

DataType
Typ: Microsoft.Office.Interop.Excel.XlTextParsingType
Format tekst, który ma być podzielony na kolumny.
Może być jednym z następujących XlTextParsingType stałych:
xlDelimited (wartość domyślna)
xlFixedWidth

TextQualifier
Typ: Microsoft.Office.Interop.Excel.XlTextQualifier
Może być jednym z następujących XlTextQualifier wartości:
xlTextQualifierDoubleQuote (wartość domyślna)
xlTextQualifierNone
xlTextQualifierSingleQuote

ConsecutiveDelimiter
Typ: System.Object
true Aby program Excel należy rozważyć ograniczniki traktuj jako jeden ogranicznik.Wartością domyślną jest false.

Tab
Typ: System.Object
true Aby DataType się xlDelimited i mieć kartę znak ogranicznika.Wartością domyślną jest false.

Semicolon
Typ: System.Object
true Aby DataType się xlDelimited i ma być ogranicznik średnik.Wartością domyślną jest false.

Comma
Typ: System.Object
true Aby DataType się xlDelimited i ma być ogranicznik przecinek.Wartością domyślną jest false.

Space
Typ: System.Object
true Aby DataType się xlDelimited i mieć miejsca znak ogranicznika.Wartością domyślną jest false.

Other
Typ: System.Object
true Aby DataType się xlDelimited i mieć znak określony przez OtherChar argument być ogranicznika.Wartością domyślną jest false.

OtherChar
Typ: System.Object
Znak ogranicznika, kiedy Other jest true.Jeśli więcej niż jeden znak jest określony, używany jest tylko pierwszy znak ciągu; pozostałe znaki są ignorowane.

FieldInfo
Typ: System.Object
Tablicę zawierającą informacje analizy poszczególnych kolumn danych.Interpretacja zależy od wartości DataType.Gdy dane jest rozdzielany, ten argument jest tablicą tablic dwuelementowe, z każdej tablicy dwuelementowe, określając opcje konwersji dla określonej kolumny.Pierwszy element jest to numer kolumny (w oparciu o 1), a drugi element jest jednym z XlColumnDataType stałe, określając, jak kolumna jest analizowany.
Może być jednym z następujących XlColumnDataType wartości:
xlGeneralFormat
xlTextFormat
xlMDYFormat
xlDMYFormat
xlYMDFormat
xlMYDFormat
xlDYMFormat
xlYDMFormat
xlEMDFormat
xlSkipColumn
Można użyć xlEMDFormat tylko wtedy, gdy obsługa języka tajwańskich jest zainstalowany i wybrany.xlEMDFormat Określa, że tajwańscy era daty są wykorzystywane.
Specyfikatory kolumn może być w dowolnej kolejności.Jeśli specyfikator dana kolumna nie ma dla określonej kolumny danych wejściowych, kolumna jest analizowany z xlGeneralFormat ustawienia.
Jeśli źródło danych zawiera kolumny o stałej szerokości, pierwszy element tablicy każdego dwuelementowe określa pozycję początkową znaków w kolumnie (jako liczba całkowita; pierwszy znak jest 0 (zero)).Drugi element tablicy dwuelementowe określa opcja analizy dla kolumny jako liczbę od 1 do 9, jak podano powyżej.

DecimalSeparator
Typ: System.Object
Separator dziesiętny, używanego przez program Excel podczas rozpoznawania liczb.Ustawieniem domyślnym jest ustawienie systemu.

ThousandsSeparator
Typ: System.Object
Tysięcy separatora, używanego przez program Excel podczas rozpoznawania liczb.Ustawieniem domyślnym jest ustawienie systemu.

TrailingMinusNumbers
Typ: System.Object
Numery zaczynają się od znaku minus.

Wartość zwracana

Typ: System.Object

Uwagi

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

Separator dziesiętny system	Separator tysięcy systemu	Wartość separatora dziesiętnego	Tysiące wartość separatora	Tekst oryginalny	Wartość komórki (typ danych)
Okres	Przecinek	Przecinek	Okres	123.123,45	123,123.45 (numeryczny)
Okres	Przecinek	Przecinek	Przecinek	123.123,45	123.123,45 (tekst)
Przecinek	Okres	Przecinek	Okres	123,123.45	123,123.45 (numeryczny)
Okres	Przecinek	Okres	Przecinek	123 123.45	123 123.45 (tekst)
Okres	Przecinek	Okres	Odstęp	123 123.45	123,123.45 (numeryczny)

Parametry opcjonalne

Informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach Office.

Przykłady

Następujący kod w przykładzie wykorzystano TextToColumns metoda, aby przekonwertować ciąg rozdzielany spacjami daty w NamedRange do trzech kolumn.

W tym przykładzie jest dla dostosowania poziomu dokumentu.

    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);
}

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.

Zobacz też

Informacje

NamedRange Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Excel

Udostępnij za pośrednictwem