NamedRange.TextToColumns – metoda

Článek
05/14/2013

Analyzuje sloupce buněk, které obsahují 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 Microsoft.Office.Interop.Excel.Range objekt, který určuje, kde bude aplikace Microsoft Office Excel umístí výsledky.Je-li rozsah hodnot 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 nabývat jedné z následujících XlTextParsingType konstanty:
xlDelimited (výchozí)
xlFixedWidth

TextQualifier
Typ: Microsoft.Office.Interop.Excel.XlTextQualifier
Může nabývat jedné 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 na kartě znak oddělovače.Výchozí hodnota je false.

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

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

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

Other
Typ: System.Object
true Chcete, aby DataType se xlDelimited a znak určený OtherChar argument být oddělovač.Výchozí hodnota je false.

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

FieldInfo
Typ: System.Object
Pole obsahující analyzovat informace pro jednotlivé sloupce dat.Výklad závisí na hodnotě DataType.V případě, že data jsou odděleny, je tento argument pole prvek 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ý prvek je jeden z XlColumnDataType konstanty určující, jak analyzovat sloupce.
Může nabývat jedné 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 tchajwanské jazyková podpora je nainstalována a vybrána.xlEMDFormat Určuje, jsou používány data tchajwanských rizik pro životní prostředí.
Specifikátory sloupců může být v libovolném pořadí.Je-li daný sloupec specifikátor není k dispozici u konkrétního sloupce vstupních dat ve sloupci je analyzován s xlGeneralFormat nastavení.
Pokud zdrojová data obsahují nulové šířky sloupců, první prvek každé dva prvky 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žnosti analýzy pro sloupec jako číslo od 1 do 9, jak je uvedeno výše.

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

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

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

Vrácená hodnota

Typ: System.Object

Poznámky

Následující tabulka obsahuje 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	Hodnota oddělovač desetinných míst	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í	Místo	123 123.45	123,123.45 (číselné)

Volitelné parametry

Informace o volitelných parametrů naleznete v tématu Volitelné parametry v Office Solutions.

Příklady

Následující příklad kódu používá TextToColumns metodu, chcete-li převést řetězec oddělený mezerami datum NamedRange na tři sloupce.

V tomto příkladu je úroveň dokument přizpůsobení.

    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

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

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

NamedRange Rozhraní

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

Sdílet prostřednictvím