本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

XmlMappedRange.TextToColumns 方法 (Object, XlTextParsingType, XlTextQualifier, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

 

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

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

object TextToColumns(
	object Destination,
	XlTextParsingType DataType = XlTextParsingType.xlDelimited,
	XlTextQualifier TextQualifier = XlTextQualifier.xlTextQualifierDoubleQuote,
	object ConsecutiveDelimiter,
	object Tab,
	object Semicolon,
	object Comma,
	object Space,
	object Other,
	object OtherChar,
	object FieldInfo,
	object DecimalSeparator,
	object ThousandsSeparator,
	object TrailingMinusNumbers
)

參數

Destination

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

DataType

要分割成數欄的文字格式。

可以是下列其中一個 XlTextParsingType 常數:

xlDelimited (預設值)

xlFixedWidth

TextQualifier

可以是下列其中一個 XlTextQualifier 值:

xlTextQualifierDoubleQuote (預設值)

xlTextQualifierNone

xlTextQualifierSingleQuote

ConsecutiveDelimiter

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

Tab

true 表示令 DataTypexlDelimited,並讓定位字元成為分隔符號。  預設值是 false  

Semicolon

true 表示令 DataTypexlDelimited,並讓分號成為分隔符號。  預設值是 false  

Comma

true 表示令 DataTypexlDelimited,並讓逗號成為分隔符號。  預設值是 false  

Space

true 表示令 DataTypexlDelimited,並讓空白字元成為分隔符號。  預設值是 false  

Other

true 表示令 DataTypexlDelimited,並讓 OtherChar 引數指定的字元成為分隔符號。  預設值是 false  

OtherChar

Othertrue 時的分隔符號字元。  如果指定多個字元,則只會使用字串中的第一個字元,剩下的字元會被忽略。  

FieldInfo

陣列,包含各個具有資料的欄之剖析資料。  轉譯會因 DataType 的值而異。  當以分隔符號分隔資料時,這個引數為雙元素陣列組成的陣列,每個雙元素陣列會為特定欄指定轉換選項。  第一個元素為欄號 (以 1 開始),第二個元素為指定如何剖析該欄的多個 XlColumnDataType 常數之一。  

可以是下列其中一個 XlColumnDataType 值:

xlGeneralFormat

xlTextFormat

xlMDYFormat

xlDMYFormat

xlYMDFormat

xlMYDFormat

xlDYMFormat

xlYDMFormat

xlEMDFormat

xlSkipColumn

您只能在已安裝並選取台灣語言支援時,才能使用 xlEMDFormat   xlEMDFormat 指定使用台灣日期。  

欄規範可以是任何順序。  如果在輸入資料中,沒有呈現特定欄的給定欄規範,則會使用 xlGeneralFormat 設定剖析欄。  

如果來源資料的欄寬固定,則每個雙元素陣列的第一個元素會指定欄中起始字元的位置 (為整數,0 (零) 表示第一個字元)。  雙元素陣列中的第二個元素會指定欄的剖析選項,為 1 到 9 的數字,如上所列。  

DecimalSeparator

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

ThousandsSeparator

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

TrailingMinusNumbers

以負號字元開始的數字。

傳回值

Type: 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 方法,將 XmlMappedRange 中以空白分隔的日期字串轉換成三個欄。  這個程式碼範例假設目前工作表包含名為 CustomerLastNameCellXmlMappedRange  

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);
}
回到頁首
顯示: