XmlMappedRange.TextToColumns Yöntem

Tanım

Ad Alanı:

Microsoft.Office.Tools.Excel

Bütünleştirilmiş Kod:

Microsoft.Office.Tools.Excel.dll

Metin içeren bir hücre sütununu birkaç sütuna ayrıştırıyor.

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

Parametreler

Destination

Object

Range Microsoft Office Excel'in sonuçları nereye yerleştirdiğini belirten bir. Aralık tek bir hücreden büyükse, sol üst hücre kullanılır.

DataType

XlTextParsingType

Sütunlara bölünecek metnin biçimi. Aşağıdaki XlTextParsingType sabitlerden biri olabilir: xlDelimited (varsayılan) xlFixedWidth

TextQualifier

XlTextQualifier

Aşağıdaki XlTextQualifier değerlerden biri olabilir: xlTextQualifierDoubleQuote (varsayılan) xlTextQualifierNonexlTextQualifierSingleQuote

ConsecutiveDelimiter

Object

true Excel'in ardışık sınırlayıcıları tek bir sınırlayıcı olarak değerlendirmesi için. false varsayılan değerdir.

Tab

Object

trueDataTypexlDelimited ve sekme karakterinin sınırlayıcı olmasını sağlayın. false varsayılan değerdir.

Semicolon

Object

trueDataTypexlDelimited olması ve noktalı virgülle sınırlayıcı olması gerekir. false varsayılan değerdir.

Comma

Object

true virgüle sahip DataType olmak xlDelimited ve virgülle sınırlayıcı olmak. false varsayılan değerdir.

Space

Object

trueDataTypexlDelimited olması ve boşluk karakterinin sınırlayıcı olması gerekir. false varsayılan değerdir.

Other

Object

trueDataTypexlDelimited olması ve bağımsız değişken tarafından belirtilen karakterin OtherChar sınırlayıcı olması. false varsayılan değerdir.

OtherChar

Object

olduğunda sınırlayıcı karakteriOther.true Birden fazla karakter belirtilirse, dizenin yalnızca ilk karakteri kullanılır; kalan karakterler yoksayılır.

FieldInfo

Object

Tek tek veri sütunları için ayrıştırma bilgilerini içeren bir dizi. Yorumlama, değerine DataTypebağlıdır. Veriler sınırlandırıldığında, bu bağımsız değişken iki öğeli dizilerden oluşan bir dizidir ve her iki öğeli dizi belirli bir sütun için dönüştürme seçeneklerini belirtir. İlk öğe sütun numarasıdır (1 tabanlı), ikinci öğe ise sütunun XlColumnDataType nasıl ayrıştırılacağını belirten sabitlerden biridir. Aşağıdaki XlColumnDataType değerlerden biri olabilir:xlTextFormatxlDMYFormatxlDYMFormatxlSkipColumnxlMDYFormatxlGeneralFormatxlMYDFormatxlYDMFormatxlYMDFormatxlEMDFormat Yalnızca Tayvan dili desteği yüklü ve seçiliyse kullanabilirsiniz.xlEMDFormat xlEMDFormat Tayvan dönemi tarihlerinin kullanıldığını belirtir. Sütun tanımlayıcıları herhangi bir sırada olabilir. Giriş verilerindeki belirli bir sütun için belirli bir sütun tanımlayıcısı yoksa, sütun ayarıyla xlGeneralFormat ayrıştırılır. Kaynak verilerde sabit genişlikli sütunlar varsa, her iki öğeli dizinin ilk öğesi sütundaki başlangıç karakteri konumunu belirtir (tamsayı olarak; 0 (sıfır) ilk karakterdir). İki öğeli dizinin ikinci öğesi, yukarıda listelendiği gibi sütun için ayrıştırma seçeneğini 1 ile 9 arasında bir sayı olarak belirtir.

DecimalSeparator

Object

Excel'in sayıları tanırken kullandığı ondalık ayırıcı. Sistem ayarı varsayılan ayardır.

ThousandsSeparator

Object

Excel'in sayıları tanıırken kullandığı binlik ayırıcısı. Sistem ayarı varsayılan ayardır.

TrailingMinusNumbers

Object

Eksi karakteriyle başlayan sayılar.

Döndürülenler

Object

Örnekler

Aşağıdaki kod örneği, bir boşlukla ayrılmış tarih dizesini XmlMappedRange üç sütuna dönüştürmek için yöntemini kullanırTextToColumns. Bu kod örneği, geçerli çalışma sayfasının adlı CustomerLastNameCellbir XmlMappedRange içerdiğini varsayar.

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

Açıklamalar

Aşağıdaki tabloda, çeşitli içeri aktarma ayarları için Excel'e metin aktarmanın sonuçları gösterilmektedir. Sayısal sonuçlar en sağdaki sütunda görüntülenir.

Sistem ondalık ayırıcısı	Binlik sistem ayırıcısı	Ondalık ayırıcı değeri	Binlik ayırıcı değeri	Özgün metin	Hücre değeri (veri türü)
Dönem	Virgül	Virgül	Dönem	123.123,45	123.123,45 (sayısal)
Dönem	Virgül	Virgül	Virgül	123.123,45	123.123,45 (metin)
Virgül	Dönem	Virgül	Dönem	123,123.45	123.123,45 (sayısal)
Dönem	Virgül	Dönem	Virgül	123 123.45	123 123,45 (metin)
Dönem	Virgül	Dönem	Alan	123 123.45	123.123,45 (sayısal)

İsteğe Bağlı Parametreler

İsteğe bağlı parametreler hakkında bilgi için bkz. Office Çözümlerinde İsteğe Bağlı Parametreler.