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

Excel에서 연속적인 구분 기호를 하나의 구분 기호로 간주하는 경우 true입니다. 기본값은 false입니다.

Tab

Object

trueDataTypexlDelimited 및 탭 문자가 구분 기호가 되도록 합니다. 기본값은 false입니다.

Semicolon

Object

trueDataTypexlDelimited 및 가 되도록 하고 세미콜론이 구분 기호가 되도록 합니다. 기본값은 false입니다.

Comma

Object

true 가 DataType 이 xlDelimited 고 쉼표가 구분 기호가 되도록 합니다. 기본값은 false입니다.

Space

Object

trueDataType 공백 문자가 xlDelimited 구분 기호가 되도록 합니다. 기본값은 false입니다.

Other

Object

trueDataType 가 이 xlDelimited 고 인수로 지정된 문자가 OtherChar 구분 기호가 되도록 합니다. 기본값은 false입니다.

OtherChar

Object

가 인 경우 Other 의 구분 기호 문자입니다 true. 여러 문자를 지정한 경우 문자열의 첫째 문자만 사용되고 나머지 문자는 무시됩니다.

FieldInfo

Object

데이터의 개별 열에 대한 구문 분석 정보가 포함된 배열입니다. 해석은 의 DataType값에 따라 달라집니다. 데이터가 구분되면 이 인수는 2요소 배열로 구성된 배열이며, 각 2요소 배열은 특정 열에 대한 변환 옵션을 지정합니다. 첫 번째 요소는 열 번호(1 기반)이며 두 번째 요소는 열 구문 분석 방법을 지정하는 상수 중 XlColumnDataType 하나입니다. 다음 XlColumnDataType 값xlTextFormatxlDMYFormatxlDYMFormatxlSkipColumnxlMDYFormatxlGeneralFormatxlMYDFormatxlYDMFormatxlYMDFormatxlEMDFormat 중 하나일 수 있습니다. 대만어 지원이 설치되고 선택된 경우에만 사용할 xlEMDFormat 수 있습니다. xlEMDFormat 는 대만 시대 날짜가 사용되고 있음을 지정합니다. 열 지정자는 임의의 순서로 지정할 수 있습니다. 입력 데이터의 특정 열에 대해 지정된 열 지정자가 없으면 해당 열은 xlGeneralFormat 설정에 따라 구문 분석됩니다. 소스 데이터의 열이 고정 폭인 경우 각 2요소 배열의 첫째 요소는 열의 시작 문자 위치(정수, 0이면 첫째 문자)를 지정합니다. 2요소 배열의 둘째 요소는 위에서 설명한 대로 1에서 9까지의 숫자로 열에 대한 구문 분석 옵션을 지정합니다.

DecimalSeparator

Object

Excel에서 숫자를 인식할 때 사용하는 소수 구분 기호입니다. 기본 설정은 시스템 설정입니다.

ThousandsSeparator

Object

Excel에서 숫자를 인식할 때 사용하는 1000 단위 구분 기호입니다. 기본 설정은 시스템 설정입니다.

TrailingMinusNumbers

Object

- 문자로 시작하는 숫자입니다.

반환

Object

예제

다음 코드 예제에서는 메서드를 사용 하 여 TextToColumns 세 개의 열에서 공백으로 구분 된 날짜 문자열을 NamedRange 변환 합니다.

이 예제는 문서 수준 사용자 지정을 위한 것입니다.

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로 가져온 결과를 보여 있습니다. 숫자 결과가 맨 오른쪽 열에 표시됩니다.

시스템 10진수 구분 기호	시스템 천 구분 기호	10진수 구분 기호 값	천 단위 구분 기호 값	원래 텍스트	셀 값(데이터 형식)
기간	쉼표	쉼표	기간	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 솔루션의 선택적 매개 변수를 참조하세요.