NamedRange.TextToColumns 메서드

아티클
05/08/2013

텍스트가 포함된 셀의 열을 여러 열로 구문 분석합니다.

네임스페이스: 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
)

매개 변수

Destination
형식: System.Object
Microsoft Office Excel에서 결과를 놓을 위치를 지정하는 Microsoft.Office.Interop.Excel.Range 개체입니다.범위가 단일 셀보다 크면 왼쪽 위 셀이 사용됩니다.

DataType
형식: Microsoft.Office.Interop.Excel.XlTextParsingType
여러 열로 분할될 텍스트의 서식입니다.
다음 XlTextParsingType 상수 중 하나일 수 있습니다.
xlDelimited (기본값)
xlFixedWidth

TextQualifier
형식: Microsoft.Office.Interop.Excel.XlTextQualifier
다음 XlTextQualifier 값 중 하나일 수 있습니다.
xlTextQualifierDoubleQuote (기본값)
xlTextQualifierNone
xlTextQualifierSingleQuote

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의 값에 따라 달라집니다.데이터가 구분되면 이 인수는 2요소 배열로 구성된 배열이며, 각 2요소 배열은 특정 열에 대한 변환 옵션을 지정합니다.첫째 요소는 1부터 시작하는 열 번호이고, 둘째 요소는 열의 구문 분석 방법을 지정하는 XlColumnDataType 상수 중 하나입니다.
다음 XlColumnDataType 값 중 하나일 수 있습니다.
xlGeneralFormat
xlTextFormat
xlMDYFormat
xlDMYFormat
xlYMDFormat
xlMYDFormat
xlDYMFormat
xlYDMFormat
xlEMDFormat
xlSkipColumn
대만어 지원이 설치 및 선택된 경우에만 xlEMDFormat을 사용할 수 있습니다.xlEMDFormat 은 대만어 날짜 서식이 사용되고 있음을 나타냅니다.
열 지정자는 임의의 순서가 될 수 있습니다.입력 데이터의 특정 열에 대해 지정된 열 지정자가 없으면 해당 열은 xlGeneralFormat 설정에 따라 구문 분석됩니다.
소스 데이터의 열이 고정 폭인 경우 각 2요소 배열의 첫째 요소는 열의 시작 문자 위치(정수, 0이면 첫째 문자)를 지정합니다.2요소 배열의 둘째 요소는 위에서 설명한 대로 1에서 9까지의 숫자로 열에 대한 구문 분석 옵션을 지정합니다.

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

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

TrailingMinusNumbers
형식: System.Object
- 문자로 시작하는 숫자입니다.

반환 값

형식: System.Object

설명

다음 표에서는 다양한 가져오기 설정으로 텍스트를 Excel로 가져온 결과를 보여 줍니다.숫자 결과는 가장 오른쪽 열에 표시됩니다.

시스템 소수 구분 기호	시스템 1000 단위 구분 기호	소수 구분 기호 값	1000 단위 구분 기호 값	원래 텍스트	셀 값(데이터 형식)
마침표	쉼표	쉼표	마침표	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 네임스페이스

다음을 통해 공유