Share via

NamedRange.TextToColumns 方法

  • 發行項

將一欄包含數個具有文字的儲存格剖析為數欄。

命名空間：  Microsoft.Office.Tools.Excel
組件：  Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

語法

'宣告
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
)

參數

  • ConsecutiveDelimiter
    型別：System.Object
    true 表示讓 Excel 將連續的分隔符號視為單一分隔符號。預設值是 false。
  • Tab
    型別：System.Object
    true 表示令 DataType 為 xlDelimited，並讓定位字元成為分隔符號。預設值是 false。
  • Semicolon
    型別：System.Object
    true 表示令 DataType 為 xlDelimited，並讓分號成為分隔符號。預設值是 false。
  • Comma
    型別：System.Object
    true 表示令 DataType 為 xlDelimited，並讓逗號成為分隔符號。預設值是 false。
  • Space
    型別：System.Object
    true 表示令 DataType 為 xlDelimited，並讓空白字元成為分隔符號。預設值是 false。
  • Other
    型別：System.Object
    true 表示令 DataType 為 xlDelimited，並讓 OtherChar 引數指定的字元成為分隔符號。預設值是 false。
  • OtherChar
    型別：System.Object
    當 Other 為 true 時的分隔符號字元。如果指定多個字元，則只會使用字串中的第一個字元，剩下的字元會被忽略。
  • FieldInfo
    型別：System.Object
    陣列，包含各個具有資料的欄之剖析資料。轉譯會因 DataType 的值而異。當以分隔符號分隔資料時，這個引數為雙元素陣列組成的陣列，每個雙元素陣列會為特定欄指定轉換選項。第一個元素為欄號 (以 1 開始)，第二個元素為指定如何剖析該欄的多個 XlColumnDataType 常數之一。
    可以是下列其中一個 XlColumnDataType 值：
    xlGeneralFormat
    xlTextFormat
    xlMDYFormat
    xlDMYFormat
    xlYMDFormat
    xlMYDFormat
    xlDYMFormat
    xlYDMFormat
    xlEMDFormat
    xlSkipColumn
    您只能在已安裝並選取台灣語言支援時，才能使用 xlEMDFormat。xlEMDFormat 指定使用台灣日期。
    欄規範可以是任何順序。如果在輸入資料中，沒有呈現特定欄的給定欄規範，則會使用 xlGeneralFormat 設定剖析欄。
    如果來源資料的欄寬固定，則每個雙元素陣列的第一個元素會指定欄中起始字元的位置 (為整數，0 (零) 表示第一個字元)。雙元素陣列中的第二個元素會指定欄的剖析選項，為 1 到 9 的數字，如上所列。
  • DecimalSeparator
    型別：System.Object
    辨認數字時 Excel 使用的小數分隔符號。預設設定是系統設定。
  • ThousandsSeparator
    型別：System.Object
    辨認數字時 Excel 使用的千分位分隔符號。預設設定是系統設定。
  • TrailingMinusNumbers
    型別：System.Object
    以負號字元開始的數字。

傳回值

型別：System.Object

備註

下表顯示以各種匯入設定將文字匯入 Excel 的結果。 數值結果顯示在最右欄中。

系統小數分隔符號

系統千分位分隔符號

小數分隔符號值

千分位分隔符號值

原始文字

儲存格值 (資料型別)

句號

逗號

逗號

句號

123.123,45

123,123.45 (數值)

句號

逗號

逗號

逗號

123.123,45

123.123,45 (文字)

逗號

句號

逗號

句號

123,123.45

123,123.45 (數值)

句號

逗號

句號

逗號

123 123.45

123,123.45 (文字)

句號

逗號

句號

空格

123 123.45

123,123.45 (數值)

選擇性參數

如需選擇性參數的詳細資訊，請參閱Office 方案中的選擇性參數。

範例

下列程式碼範例使用 TextToColumns 方法，將 NamedRange 中以空白分隔的日期字串轉換成三個欄。

這是示範文件層級自訂的範例。

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

.NET Framework 安全性

請參閱

參考

NamedRange 介面

Microsoft.Office.Tools.Excel 命名空間