XmlMappedRange.TextToColumns メソッド

定義

テキストが含まれたセルの列を区切り、複数の列に分割します。

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

Microsoft Office Excel が結果を配置する位置を示す Range です。 範囲が複数のセルから成る場合、左上のセルが使用されます。

DataType
XlTextParsingType

列に分割するテキストの形式。使用できる定数は、次 XlTextParsingType のいずれかです。 xlDelimited (既定値) xlFixedWidth

TextQualifier
XlTextQualifier

次のいずれかの値を XlTextQualifier 指定できます: xlTextQualifierDoubleQuote (既定値) xlTextQualifierNonexlTextQualifierSingleQuote

ConsecutiveDelimiter
Object

連続する区切り記号を 1 つの区切り記号と見なす場合は true です。 既定値は false です。

Tab
Object

trueDataTypexlDelimitedタブ文字を区切り記号にする場合は 。 既定値は false です。

Semicolon
Object

trueDataTypeは でありxlDelimited、セミコロンを区切り記号にする場合は 。 既定値は false です。

Comma
Object

trueDataTypexlDelimitedコンマを区切り記号にする場合は と を指定します。 既定値は false です。

Space
Object

trueDataTypexlDelimitedスペース文字を区切り記号にする場合は 。 既定値は false です。

Other
Object

trueDataTypexlDelimited引数でOtherChar指定された文字を区切り記号にする場合は と を指定します。 既定値は false です。

OtherChar
Object

が の場合Othertrueの区切り文字。 複数の文字を指定した場合、文字列の最初の文字だけが使用され、残りの文字は無視されます。

FieldInfo
Object

個々のデータ列を区切るための情報を含む配列です。 解釈は の DataType値によって異なります。 データが区切られている場合には、この引数は、2 要素配列の配列です。各 2 要素配列には、個々の列の変換オプションを指定します。 最初の要素は列番号 (1 から始まる) で、2 番目の要素は列のXlColumnDataType解析方法を指定する定数の 1 つです。次のいずれかの値を指定できます。xlTextFormatxlMDYFormatxlGeneralFormatxlDMYFormatxlYDMFormatxlSkipColumnxlYMDFormatxlMYDFormatxlDYMFormatxlEMDFormat使用できるのは、台湾語のサポートがインストールされ、選択されている場合のみです。xlEMDFormatXlColumnDataType xlEMDFormat は、台湾の元号の日付が使用されていることを指定します。列指定子は任意の順序で指定できます。 入力データの特定の列に対応する列指定子が指定されていない場合は、その列は xlGeneralFormat 設定で区切られます。 参照元データに固定幅の列がある場合は、各 2 要素配列の 1 つ目の要素は、列の開始文字の位置を示す整数です (最初の文字が 0 (ゼロ))。 2 要素配列の 2 つ目の要素は、列区切りのオプションを示す、上記の一覧と同じ 1 ~ 9 の数値です。

DecimalSeparator
Object

Excel が数値を認識するときに使用する小数点の記号です。 既定はシステム設定です。

ThousandsSeparator
Object

Excel が数値を認識するときに使用する桁区切り記号です。 既定はシステム設定です。

TrailingMinusNumbers
Object

マイナス文字で始まる数値です。

戻り値

次のコード例では、 メソッドを TextToColumns 使用して、 内のスペース区切りの日付文字列を XmlMappedRange 3 つの列に変換します。 このコード例では、現在のワークシートに という名前CustomerLastNameCellの が含まれていることをXmlMappedRange前提としています。

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 ソリューションの省略可能なパラメーター」を参照してください。

適用対象