Metoda NamedRange.TextToColumns —

Artykuł
05/08/2013

Analizuje kolumny komórek, zawierających 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, gdzie program Microsoft Office Excel spowoduje umieszczenie wyników.Jeśli zakres jest większy niż pojedynczą komórkę, górna lewa komórka jest używany.

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

TextQualifier
Typ: Microsoft.Office.Interop.Excel.XlTextQualifier
Może być jedną z następujących XlTextQualifier wartości:
xlTextQualifierDoubleQuote (domyślnie)
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 mieć być ogranicznik średnik.Wartością domyślną jest false.

Comma
Typ: System.Object
true Aby DataType się xlDelimited i mieć 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ć ogranicznik.Wartością domyślną jest false.

OtherChar
Typ: System.Object
Znak ogranicznika, gdy 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 ograniczony, 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ć jedną 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, czy są używane daty tajwańskich oceny zagrożenia ekologicznego.
Specyfikator kolumny można w dowolnej kolejności.Jeśli specyfikator dana kolumna nie ma dla określonej kolumny danych wejściowych, kolumna jest analizowany z xlGeneralFormat ustawienie.
Jeśli źródło danych zawiera stałej szerokości kolumn, pierwszy element każdej tablicy dwuelementowe określa pozycję początkową znaku w kolumnie (w postaci liczby całkowitej; 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żywanych przez program Excel podczas uznając liczb.Ustawieniem domyślnym jest ustawienie systemu.

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

TrailingMinusNumbers
Typ: System.Object
Numery zaczynać się od znaku minus.

Wartość zwracana

Typ: System.Object

Uwagi

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

Separator dziesiętny system	Separator systemowy tysięcy	Wartość separator dziesiętny	Tysiące wartość separatora	Oryginalny tekst	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	Miejsca	123 123.45	123,123.45 (numeryczny)

Parametry opcjonalne

Aby uzyskać informacje o opcjonalnych parametrów, zobacz Parametry opcjonalne w rozwiązania dla pakietu Office.

Przykłady

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

Ten przykład dotyczy dostosowywania poziomie 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 Przy użyciu bibliotek z częściowo zaufanego kodu..

Zobacz też

Informacje

NamedRange Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Excel

Udostępnij za pośrednictwem