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

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

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

戻り値

Object

例

次のコード例では、 メソッドを TextToColumns 使用して、 内のスペース区切りの日付文字列を NamedRange 3 つの列に変換します。

この例は、ドキュメント レベルのカスタマイズ用です。

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 にテキストをインポートした結果を示しています。 数値の結果が右端の列に表示されます。

システム小数点区切り記号	システムの桁区切り記号	小数点区切り記号の値	桁区切り記号の値	元のテキスト	セル値 (データ型)
期間	コンマ	コンマ	期間	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 ソリューションの省略可能なパラメーター」を参照してください。