Udostępnij za pośrednictwem

Metoda XmlMappedRange.TextToColumns —

  • Artykuł

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 Range , która określa gdzie program Microsoft Office Excel umieszcza wyniki.Jeśli zakres jest większy niż pojedynczą komórkę, lewą górną komórkę jest używany.
  • 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 XmlMappedRange do trzech kolumn.W tym przykładzie kodu zakłada, że bieżący arkusz zawiera XmlMappedRange o nazwie CustomerLastNameCell.

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

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

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

XmlMappedRange Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Excel