XmlMappedRange.TextToColumns Metode

Definisi

Ruang nama:

Microsoft.Office.Tools.Excel

Rakitan:

Microsoft.Office.Tools.Excel.dll

Mengurai kolom sel yang berisi teks ke dalam beberapa kolom.

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

Parameter

Destination

Object

Range Yang menentukan tempat Microsoft Office Excel menempatkan hasilnya. Jika rentang lebih besar dari sel tunggal, sel kiri atas akan digunakan.

DataType

XlTextParsingType

Format teks yang akan dibagi menjadi kolom. Bisa menjadi salah satu konstanta berikut XlTextParsingType : xlDelimited (default) xlFixedWidth

TextQualifier

XlTextQualifier

Bisa menjadi salah satu nilai berikut XlTextQualifier : xlTextQualifierDoubleQuote (default) xlTextQualifierNonexlTextQualifierSingleQuote

ConsecutiveDelimiter

Object

true agar Excel mempertimbangkan pemisah berturut-turut sebagai satu pemisah. Nilai defaultnya adalah false.

Tab

Object

trueDataType memiliki dan xlDelimited memiliki karakter tab menjadi pemisah. Nilai defaultnya adalah false.

Semicolon

Object

trueDataType memiliki dan xlDelimited memiliki titik koma menjadi pemisah. Nilai defaultnya adalah false.

Comma

Object

trueDataType memiliki dan xlDelimited memiliki koma menjadi pemisah. Nilai defaultnya adalah false.

Space

Object

trueDataType memiliki dan xlDelimited memiliki karakter spasi menjadi pemisah. Nilai defaultnya adalah false.

Other

Object

trueDataType memiliki dan xlDelimited memiliki karakter yang ditentukan oleh argumen menjadi pemisahOtherChar. Nilai defaultnya adalah false.

OtherChar

Object

Karakter pemisah ketika Other adalah true. Jika lebih dari satu karakter ditentukan, hanya karakter pertama dari string yang digunakan; karakter yang tersisa diabaikan.

FieldInfo

Object

Array yang berisi informasi penguraian untuk masing-masing kolom data. Interpretasi tergantung pada nilai DataType. Saat data dibatasi, argumen ini adalah array array dua elemen, dengan setiap array dua elemen menentukan opsi konversi untuk kolom tertentu. Elemen pertama adalah nomor kolom (berbasis 1), dan elemen kedua adalah salah XlColumnDataType satu konstanta yang menentukan bagaimana kolom diurai. Bisa menjadi salah satu nilai berikutXlColumnDataType:xlTextFormatxlDMYFormatxlYMDFormatxlMYDFormatxlMDYFormatxlGeneralFormatxlYDMFormatxlEMDFormatxlDYMFormatxlSkipColumn Anda hanya dapat menggunakan xlEMDFormat jika dukungan bahasa Taiwan diinstal dan dipilih. xlEMDFormat menentukan bahwa tanggal era Taiwan sedang digunakan. Penentu kolom dapat berada dalam urutan apa pun. Jika penentu kolom tertentu tidak ada untuk kolom tertentu dalam data input, kolom diurai dengan xlGeneralFormat pengaturan . Jika data sumber memiliki kolom lebar tetap, elemen pertama dari setiap array dua elemen menentukan posisi karakter awal di kolom (sebagai bilangan bulat; 0 (nol) adalah karakter pertama). Elemen kedua dari array dua elemen menentukan opsi penguraian untuk kolom sebagai angka dari 1 hingga 9, seperti yang tercantum di atas.

DecimalSeparator

Object

Pemisah desimal yang digunakan Excel saat mengenali angka. Pengaturan default adalah pengaturan sistem.

ThousandsSeparator

Object

Pemisah ribuan yang digunakan Excel saat mengenali angka. Pengaturan default adalah pengaturan sistem.

TrailingMinusNumbers

Object

Angka yang dimulai dengan karakter minus.

Mengembalikan

Object

Contoh

Contoh kode berikut menggunakan TextToColumns metode untuk mengonversi string tanggal yang dibatasi spasi dalam satu XmlMappedRange hingga tiga kolom. Contoh kode ini mengasumsikan bahwa lembar kerja saat ini berisi yang XmlMappedRange bernama CustomerLastNameCell.

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

Keterangan

Tabel berikut ini memperlihatkan hasil mengimpor teks ke Excel untuk berbagai pengaturan impor. Hasil numerik ditampilkan di kolom paling kanan.

Pemisah desimal sistem	Pemisah ribuan sistem	Nilai pemisah desimal	Nilai pemisah ribuan	Teks asli	Nilai sel (tipe data)
Periode	Koma	Koma	Periode	123.123,45	123.123,45 (numerik)
Periode	Koma	Koma	Koma	123.123,45	123.123,45 (teks)
Koma	Periode	Koma	Periode	123,123.45	123.123,45 (numerik)
Periode	Koma	Periode	Koma	123 123.45	123 123,45 (teks)
Periode	Koma	Periode	Space	123 123.45	123.123,45 (numerik)

Parameter Opsional

Untuk informasi tentang parameter opsional, lihat Parameter Opsional di Solusi Office.