XmlMappedRange.TextToColumns – metoda

Článek
01/03/2014

Analyzuje sloupec buněk obsahujících text do několika sloupců.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Deklarace
Function TextToColumns ( _
    Destination As Object, _
    DataType As XlTextParsingType, _
    TextQualifier As XlTextQualifier, _
    ConsecutiveDelimiter As Object, _
    Tab As Object, _
    Semicolon As Object, _
    Comma As Object, _
    Space As Object, _
    Other As Object, _
    OtherChar As Object, _
    FieldInfo As Object, _
    DecimalSeparator As Object, _
    ThousandsSeparator As Object, _
    TrailingMinusNumbers As Object _
) As Object

Object TextToColumns(
    Object Destination,
    XlTextParsingType DataType,
    XlTextQualifier TextQualifier,
    Object ConsecutiveDelimiter,
    Object Tab,
    Object Semicolon,
    Object Comma,
    Object Space,
    Object Other,
    Object OtherChar,
    Object FieldInfo,
    Object DecimalSeparator,
    Object ThousandsSeparator,
    Object TrailingMinusNumbers
)

Parametry

Destination
Typ: System.Object
A Range , určuje, kam aplikace Microsoft Office Excel umístí výsledky.Je-li rozsah je větší než jedna buňka, levá horní buňka slouží.

DataType
Typ: Microsoft.Office.Interop.Excel.XlTextParsingType
Formát text rozdělit do sloupců.
Může být jeden z následujících XlTextParsingType konstanty:
xlDelimited (výchozí)
xlFixedWidth

TextQualifier
Typ: Microsoft.Office.Interop.Excel.XlTextQualifier
Může být jeden z následujících XlTextQualifier hodnoty:
xlTextQualifierDoubleQuote (výchozí)
xlTextQualifierNone
xlTextQualifierSingleQuote

ConsecutiveDelimiter
Typ: System.Object
true Chcete-li v aplikaci Excel zvažte Posloupnost oddělovačů jako jeden oddělovač.Výchozí hodnota je false.

Tab
Typ: System.Object
true Chcete-li mít DataType se xlDelimited a mít kartu znak oddělovače.Výchozí hodnota je false.

Semicolon
Typ: System.Object
true Chcete-li mít DataType se xlDelimited a mají být oddělovač středník.Výchozí hodnota je false.

Comma
Typ: System.Object
true Chcete-li mít DataType se xlDelimited a mají být oddělovač čárku.Výchozí hodnota je false.

Space
Typ: System.Object
true Chcete-li mít DataType se xlDelimited a mít místo znaku oddělovače.Výchozí hodnota je false.

Other
Typ: System.Object
true mít DataType se xlDelimited a mají znak definovaný OtherChar argument být oddělovač.Výchozí hodnota je false.

OtherChar
Typ: System.Object
Znak oddělovače, při Other je true.Pokud více než jeden znak je specifikován, že je použito pouze první znak řetězce; Zbývající znaky jsou ignorovány.

FieldInfo
Typ: System.Object
Pole obsahující informace, analýzy pro jednotlivé sloupce dat.Výklad závisí na hodnotě DataType.Pokud data s oddělovačem je tento argument pole prvku dvou polí s každou dvouprvkovou matici zadáním možnosti převodu u konkrétního sloupce.Prvním prvkem je číslo sloupce (založený na 1) a druhá část je jedním z XlColumnDataType konstanty určující, jak je analyzován ve sloupci.
Může být jeden z následujících XlColumnDataType hodnoty:
xlGeneralFormat
xlTextFormat
xlMDYFormat
xlDMYFormat
xlYMDFormat
xlMYDFormat
xlDYMFormat
xlYDMFormat
xlEMDFormat
xlSkipColumn
Můžete použít xlEMDFormat pouze v případě, že je nainstalována a vybrána tchajwanských jazyková podpora.xlEMDFormat Určuje, že tchajwanských EVP data jsou používána.
Specifikátory sloupců může být v libovolném pořadí.Pokud je daný sloupec specifikátor není k dispozici u konkrétního sloupce vstupních dat sloupce je analyzován s xlGeneralFormat nastavení.
Pokud zdrojová data obsahují sloupce s pevnou šířkou, první prvek každé dvě prvek pole určuje počáteční pozici znaku ve sloupci (jako celé číslo; první znak je 0 (nula)).Druhý prvek dvouprvkovou matici určuje možnost analýzy pro sloupec jako číslo od 1 do 9, jak je uvedeno výše.

DecimalSeparator
Typ: System.Object
Oddělovač desetinných míst, které aplikace Excel používá při rozpoznávání čísla.Ve výchozím nastavení je nastavení systému.

ThousandsSeparator
Typ: System.Object
Tisíců oddělovače, které aplikace Excel používá při rozpoznávání čísla.Ve výchozím nastavení je nastavení systému.

TrailingMinusNumbers
Typ: System.Object
Čísla, která začínají mínus znak.

Vrácená hodnota

Typ: System.Object

Poznámky

Následující tabulka zobrazuje výsledky pro různé nastavení importu import textu do aplikace Excel.Číselné výsledky jsou zobrazeny ve sloupci zcela vpravo.

Oddělovač desetinných míst v systému	Oddělovač tisíců systému	Desetinnou hodnotu.	Tisíců oddělovač hodnot	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í	Mezera	123 123.45	123,123.45 (číselné)

Volitelné parametry

Informace o nepovinných parametrů naleznete v tématu Volitelné parametry v řešeních pro systém Office.

Příklady

Následující příklad kódu používá TextToColumns metoda převést řetězec oddělený mezerami datum v XmlMappedRange na tři sloupce.Tento kód příklad předpokládá, že obsahuje aktuální list XmlMappedRange s názvem CustomerLastNameCell.

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

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);
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

XmlMappedRange Rozhraní

Microsoft.Office.Tools.Excel – obor názvů

Sdílet prostřednictvím