XmlMappedRange.TextToColumns Metoda

Definice

Obor názvů:

Microsoft.Office.Tools.Excel

Sestavení:

Microsoft.Office.Tools.Excel.dll

Analyzuje sloupec buněk, které obsahují text, do několika sloupců.

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

Parametry

Destination

Object

A Range , který určuje, kam Microsoft Office Excel umístí výsledky. Pokud je oblast větší než jedna buňka, použije se levá horní buňka.

DataType

XlTextParsingType

Formát textu, který se má rozdělit do sloupců. Může to být jedna z následujících XlTextParsingType konstant: xlDelimited (výchozí) xlFixedWidth

TextQualifier

XlTextQualifier

Může to být jedna z následujících XlTextQualifier hodnot: xlTextQualifierDoubleQuote (výchozí) xlTextQualifierNonexlTextQualifierSingleQuote

ConsecutiveDelimiter

Object

true pokud chcete, aby Excel považoval po sobě jdoucí oddělovače za jeden oddělovač. Výchozí hodnota je false.

Tab

Object

true DataType musí být xlDelimited a aby znak tabulátoru byl oddělovač. Výchozí hodnota je false.

Semicolon

Object

true DataType musí být xlDelimited a aby středník byl oddělovačem. Výchozí hodnota je false.

Comma

Object

true DataType musí být xlDelimited a aby čárka byla oddělovačem. Výchozí hodnota je false.

Space

Object

true DataType musí být xlDelimited a aby znak mezery byl oddělovačem. Výchozí hodnota je false.

Other

Object

true DataType musí být xlDelimited a aby znak určený argumentem OtherChar byl oddělovačem. Výchozí hodnota je false.

OtherChar

Object

Znak oddělovače, pokud Other je true. Pokud je zadáno více než jeden znak, je použit pouze první znak řetězce; zbývající znaky budou ignorovány.

FieldInfo

Object

Pole obsahující informace o analýze jednotlivých sloupců dat. Interpretace závisí na hodnotě .DataType Pokud jsou data oddělena, je tento argument pole se dvěma prvky, přičemž každé pole se dvěma prvky určuje možnosti převodu pro konkrétní sloupec. První prvek je číslo sloupce (založené na 1) a druhý prvek je jednou z XlColumnDataType konstant určující, jak se sloupec analyzuje. Může to být jedna z následujících XlColumnDataType hodnot: xlGeneralFormatxlMDYFormatxlYMDFormatxlMYDFormatxlDMYFormatxlTextFormatxlYDMFormatxlEMDFormatxlDYMFormatxlSkipColumn Můžete použít xlEMDFormat jenom v případě, že je nainstalovaná a vybraná podpora tchajwanského jazyka. xlEMDFormat určuje, že se používají data tchajwanské éry. Specifikátory sloupců můžou být v libovolném pořadí. Pokud daný specifikátor sloupce není k dispozici pro konkrétní sloupec ve vstupních datech, sloupec se parsuje s xlGeneralFormat nastavením. Pokud zdrojová data obsahují sloupce s pevnou šířkou, určuje první prvek každého pole se dvěma prvky počáteční pozici znaku ve sloupci (jako celé číslo; 0 (nula) je první znak). Druhý prvek pole se dvěma prvky určuje možnost parsování sloupce jako číslo od 1 do 9, jak je uvedeno výše.

DecimalSeparator

Object

Oddělovač desetinných míst, který Excel používá při rozpoznávání čísel. Výchozí nastavení je nastavení systému.

ThousandsSeparator

Object

Oddělovač tisíců, který Excel používá při rozpoznávání čísel. Výchozí nastavení je nastavení systému.

TrailingMinusNumbers

Object

Čísla, která začínají znakem mínus.

Návraty

Object

Příklady

Následující příklad kódu používá metodu TextToColumns k převodu řetězce data odděleného mezerami XmlMappedRange v rámci do tří sloupců. Tento příklad kódu předpokládá, že aktuální list obsahuje pojmenovaný XmlMappedRangeCustomerLastNameCell.

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

Poznámky

Následující tabulka ukazuje výsledky importu textu do Excelu pro různá nastavení importu. Číselné výsledky se zobrazují ve sloupci nejvíce vpravo.

Oddělovač desetinných míst systému	Oddělovač tisíců systému	Hodnota oddělovače desetinných míst	Hodnota oddělovače tisíců	Původní text	Hodnota buňky (datový typ)
Období	Čárka	Čárka	Období	123.123,45	123 123,45 (číselné)
Období	Čárka	Čárka	Čárka	123.123,45	123.123,45 (text)
Čárka	Období	Čárka	Období	123,123.45	123 123,45 (číselné)
Období	Čárka	Období	Čárka	123 123.45	123 123,45 (text)
Období	Čárka	Období	Místo	123 123.45	123 123,45 (číselné)

Volitelné parametry

Informace o volitelných parametrech najdete v tématu Volitelné parametry v řešeních pro Systém Office.