XmlMappedRange.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

如果让 Excel 将连续分隔符视为一个分隔符，则为 true。 默认值为 false。

Tab

Object

trueDataTypexlDelimited为 ，将制表符设置为分隔符。 默认值为 false。

Semicolon

Object

trueDataTypexlDelimited为 ，并且将分号设置为分隔符。 默认值为 false。

Comma

Object

trueDataTypexlDelimited为 ，将逗号设置为分隔符。 默认值为 false。

Space

Object

trueDataTypexlDelimited为 ，将空格字符设置为分隔符。 默认值为 false。

Other

Object

true 如果为 DataTypexlDelimited ，则参数指定的 OtherChar 字符为分隔符。 默认值为 false。

OtherChar

Object

为 时的Othertrue分隔符字符。 如果指定了多个字符，则只使用该字符串的第一个字符；忽略其余字符。

FieldInfo

Object

一个数组，包含各个数据列的分析信息。 解释取决于 的值 DataType。 当对数据进行分隔时，此参数是一个由两元素数组组成的数组，每个两元素数组都指定特定列的转换选项。 第一个元素是列号 (从 1 开始的) ，第二个元素是指定列分析方式的XlColumnDataType常量之一。可以是以下XlColumnDataType值之一：xlTextFormatxlDMYFormatxlDYMFormatxlSkipColumnxlMDYFormatxlGeneralFormatxlMYDFormatxlYDMFormatxlYMDFormatxlEMDFormat仅当已安装并选择了台湾语言支持时，才能使用 。xlEMDFormat xlEMDFormat 指定正在使用台湾纪元日期。列说明符可以按任意顺序排列。 如果对于输入数据中的特定列，给定的列说明符不存在，则用 xlGeneralFormat 设置对列进行分析。 如果源数据具有固定宽度的列，则每个两元素数组中的第一个元素都指定该列中的起始字符位置（以整数形式指定；0（零）是第一个字符）。 两元素数组的第二个元素将该列的分析选项指定为从 1 至 9 的数字，如上面列出的那样。

DecimalSeparator

Object

Excel 用于识别数字的小数点分隔符。 默认设置是系统设置。

ThousandsSeparator

Object

Excel 用于识别数字的千位分隔符。 默认设置是系统设置。

TrailingMinusNumbers

Object

以负号开头的数字。

返回

Object

示例

下面的代码示例使用 TextToColumns 方法将 中的 XmlMappedRange 空格分隔的日期字符串转换为三列。 此代码示例假定当前工作表包含名为 XmlMappedRange 的 CustomerLastNameCell。

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

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

注解

下表显示了针对各种导入设置将文本导入 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 (文本)
周期	逗号	周期	Space	123 123.45	123,123.45 (数字)

可选参数

有关可选参数的信息，请参阅 Office 解决方案中的可选参数。