通过

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
    如果让 Excel 将连续分隔符视为一个分隔符，则为 true。默认值为 false。
  • Tab
    类型：System.Object
    如果让 DataType 为 xlDelimited，并将制表符用作分隔符，则为 true。默认值为 false。
  • Semicolon
    类型：System.Object
    如果让 DataType 为 xlDelimited，并将分号用作分隔符，则为 true。默认值为 false。
  • Comma
    类型：System.Object
    如果让 DataType 为 xlDelimited，并将逗号用作分隔符，则为 true。默认值为 false。
  • Space
    类型：System.Object
    如果让 DataType 为 xlDelimited，并且将空格字符用作分隔符，则为 true。默认值为 false。
  • Other
    类型：System.Object
    如果让 DataType 为 xlDelimited，并且将 OtherChar 参数指定的字符用作分隔符，则为 true。默认值为 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 命名空间