NamedRange.TextToColumns Metoda

Reference

Definice

Obor názvů:: Microsoft.Office.Tools.Excel

Sestavení:: Microsoft.Office.Tools.Excel.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Objekt Range , který určuje, kam bude aplikace Microsoft Office Excel umístit 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 mít jednu z následujících XlTextQualifier hodnot: xlTextQualifierDoubleQuote (výchozí) xlTextQualifierNone xlTextQualifierSingleQuote

ConsecutiveDelimiter: Object

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

Tab: Object

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

Semicolon: Object

trueDataType musí být xlDelimited a středník musí být oddělovač. Výchozí hodnota je false.

Comma: Object

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

Space: Object

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

Other: Object

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

OtherChar: Object

Oddělovač, 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í parsování informací pro jednotlivé sloupce 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ích, jak se sloupec analyzuje. Může mít jednu z následujících XlColumnDataType hodnot:xlTextFormat xlDMYFormat xlYMDFormat xlMYDFormat xlMDYFormat xlGeneralFormat xlYDMFormat xlEMDFormat xlDYMFormat xlSkipColumn Můžete použít xlEMDFormat pouze v případě, že je nainstalovaná a vybraná podpora tchaj-wanštiny. 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í pro konkrétní sloupec ve vstupních datech k dispozici, bude sloupec analyzován s xlGeneralFormat nastavením . Pokud zdrojová data obsahují sloupce s pevnou šířkou, určuje první prvek každého pole se dvěma prvky pozici počátečního znaku ve sloupci (jako celé číslo; 0 (nula) je první znak). Druhý prvek pole se dvěma prvky určuje možnost parse 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í mínusem.

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 NamedRange ve třech sloupcích.

Tento příklad je pro přizpůsobení na úrovni dokumentu.

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

Poznámky

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

Systémový oddělovač desetinných míst	Systémový oddělovač tisíců	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.

Platí pro