NamedRange.TextToColumns 方法

  • 參考

定義

命名空間:
Microsoft.Office.Tools.Excel
組件:
Microsoft.Office.Tools.Excel.dll

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

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

參數

Destination
Object

Range，用來指定 Microsoft Office Excel 會放入結果的位置。 如果範圍大於一個儲存格，則使用左上角儲存格。

DataType
XlTextParsingType

要分割成數據行的文字格式。可以是下列 XlTextParsingType 其中一個常數： xlDelimited (預設) xlFixedWidth

TextQualifier
XlTextQualifier

可以是下列 XlTextQualifier 其中一個值： xlTextQualifierDoubleQuote (預設) xlTextQualifierNonexlTextQualifierSingleQuote

ConsecutiveDelimiter
Object

true 表示讓 Excel 將連續的分隔符號視為單一分隔符號。 預設值是 false。

Tab
Object

true 必須是 DataTypexlDelimited ，而且索引標籤位必須是分隔符。 預設值是 false。

Semicolon
Object

true 必須是 DataTypexlDelimited ，且將分號設為分隔符。 預設值是 false。

Comma
Object

true 必須是 DataTypexlDelimited ，且逗號為分隔符。 預設值是 false。

Space
Object

true 必須是 DataTypexlDelimited 和 ，讓空格字元成為分隔符。 預設值是 false。

Other
Object

true 必須是 DataTypexlDelimited ，而且要讓 自變數指定的 OtherChar 字元成為分隔符。 預設值是 false。

OtherChar
Object

當 為 時Other，分隔符。true 如果指定多個字元，則只會使用字串中的第一個字元，剩下的字元會被忽略。

FieldInfo
Object

陣列，包含各個具有資料的欄之剖析資料。 解譯取決於的值 DataType。 當以分隔符號分隔資料時，這個引數為雙元素陣列組成的陣列，每個雙元素陣列會為特定欄指定轉換選項。 第一個元素是以數據行編號 (以 1 為基礎的) ，而第二個元素則是指定如何剖析數據行的XlColumnDataType其中一個常數。可以是下列XlColumnDataType其中一個值：xlTextFormatxlDYMFormatxlMYDFormatxlEMDFormatxlSkipColumnxlDMYFormatxlGeneralFormatxlYDMFormatxlMDYFormatxlYMDFormat只有在安裝並選取臺灣語言支援時，才可以使用。xlEMDFormat xlEMDFormat 會指定使用臺灣紀元日期。數據行規範可以依任何順序排列。 如果在輸入資料中，沒有呈現特定欄的給定欄規範，則會使用 xlGeneralFormat 設定剖析欄。 如果來源資料的欄寬固定，則每個雙元素陣列的第一個元素會指定欄中起始字元的位置 (為整數，0 (零) 表示第一個字元)。 雙元素陣列中的第二個元素會指定欄的剖析選項，為 1 到 9 的數字，如上所列。

DecimalSeparator
Object

辨認數字時 Excel 使用的小數分隔符號。 預設設定是系統設定。

ThousandsSeparator
Object

辨認數字時 Excel 使用的千分位分隔符號。 預設設定是系統設定。

TrailingMinusNumbers
Object

以負號字元開始的數字。

傳回

Object

範例

下列程式代碼範例會使用 方法， TextToColumns 將 中的 NamedRange 空格分隔日期字串轉換成三個數據行。

此範例適用於檔層級自定義。

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

備註

下表顯示針對各種匯入設定，將文字匯入 Excel 的結果。 數值結果會顯示在最右邊的數據行中。

系統小數分隔符 系統千位分隔符 小數分隔符值 千位分隔符值 原始文字 數據格值 (數據類型)
期間 Comma (逗號) Comma (逗號) 期間 123.123,45 123,123.45 (數值)
期間 Comma (逗號) Comma (逗號) Comma (逗號) 123.123,45 123.123,45 (文字)
Comma (逗號) 期間 Comma (逗號) 期間 123,123.45 123,123.45 (數值)
期間 Comma (逗號) 期間 Comma (逗號) 123 123.45 123 123.45 (文字)
期間 Comma (逗號) 期間 Space 123 123.45 123,123.45 (數值)

選擇性參數

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

適用於