NamedRange.TextToColumns Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
Objek Range yang menentukan di mana Microsoft Office Excel akan 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
true
DataType
memiliki dan xlDelimited memiliki karakter tab menjadi pemisah. Nilai defaultnya adalah false
.
- Semicolon
- Object
true
DataType
memiliki dan xlDelimited memiliki titik koma menjadi pemisah. Nilai defaultnya adalah false
.
- Comma
- Object
true
DataType
memiliki dan xlDelimited memiliki koma menjadi pemisah. Nilai defaultnya adalah false
.
- Space
- Object
true
DataType
memiliki dan xlDelimited memiliki karakter spasi menjadi pemisah. Nilai defaultnya adalah false
.
- Other
- Object
true
DataType
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
Contoh
Contoh kode berikut menggunakan TextToColumns metode untuk mengonversi string tanggal yang dibatasi spasi dalam menjadi NamedRange tiga kolom.
Contoh ini untuk kustomisasi tingkat dokumen.
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
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.