다음을 통해 공유

XmlMappedRange.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 상수 중 하나일 수 있습니다(기본값). xlDelimitedxlFixedWidth

TextQualifier
XlTextQualifier

다음 XlTextQualifier 값 xlTextQualifierDoubleQuote 중 하나일 수 있습니다(기본값). xlTextQualifierNonexlTextQualifierSingleQuote

ConsecutiveDelimiter
Object

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

Tab
Object

true 가 DataType 이 xlDelimited 고 탭 문자가 구분 기호가 되도록 하려면 입니다. 기본값은 false입니다.

Semicolon
Object

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

Comma
Object

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

Space
Object

true 가 DataType 이 xlDelimited 고 공백 문자가 구분 기호가 되도록 하려면 입니다. 기본값은 false입니다.

Other
Object

true 가 DataTypexlDelimited 이고 인수에 지정된 문자가 OtherChar 구분 기호가 되도록 하려면 입니다. 기본값은 false입니다.

OtherChar
Object

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

FieldInfo
Object

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

DecimalSeparator
Object

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

ThousandsSeparator
Object

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

TrailingMinusNumbers
Object

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

반환

Object

예제

다음 코드 예제에서는 메서드를 TextToColumns 사용 하 여 3 개의 열 내에서 XmlMappedRange 공백으로 구분 된 날짜 문자열을 변환 합니다. 이 코드 예제에서는 현재 워크시트에 라는 가 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로 가져온 결과를 보여 있습니다. 숫자 결과가 맨 오른쪽 열에 표시됩니다.

시스템 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 솔루션의 선택적 매개 변수를 참조하세요.

적용 대상