NamedRange.TextToColumns – metoda
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 Microsoft.Office.Interop.Excel.Range objekt Určuje, kde systém Microsoft Office Excel umístí výsledky.Pokud je oblast větší než jedna buňka, levá horní buňka použit.
- 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 aplikaci Excel zvažte Posloupnost oddělovačů jako jeden oddělovač.Výchozí hodnota je false.
- Tab
Typ: System.Object
true mít DataType se xlDelimited a znak tabulátoru se oddělovač.Výchozí hodnota je false.
- Semicolon
Typ: System.Object
true mít DataType se xlDelimited a středník být oddělovač.Výchozí hodnota je false.
- Comma
Typ: System.Object
true mít DataType se xlDelimited a čárka být oddělovač.Výchozí hodnota je false.
- Space
Typ: System.Object
true mít DataType se xlDelimited a znak mezery být oddělovač.Výchozí hodnota je false.
- Other
Typ: System.Object
true mít DataType se xlDelimited a znak určený OtherCharbýtargument 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 zadán, že je použit pouze první znak řetězce; Zbývající znaky budou ignorovány.
- FieldInfo
Typ: System.Object
Pole obsahující informace pro jednotlivé sloupce data analyzovat.Výklad závisí na hodnotě DataType.Při data s oddělovačem je tento argument pole prvek dvou polí s každý prvek dvě pole možnosti převodu u konkrétního sloupce.Prvním prvkem je číslo sloupce (založené na 1) a druhý prvek je jednou z XlColumnDataType konstanty určující, jak analyzovat sloupce.
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 pokud je nainstalována a vybrána tchajwanských jazyková podpora.xlEMDFormatUrčuje použito tchajwanských EVP data.
Specifikátory sloupců lze v libovolném pořadí.Pokud daný sloupec specifikátor není k dispozici u konkrétního sloupce vstupních dat je sloupec s analyzován xlGeneralFormat nastavení.
Pokud zdrojová databáze data obsahují pevné šířky sloupců, první prvek každého prvku dvě pole určuje počáteční pozici znaku ve sloupci (jako integer; první znak je 0 (nula)).Druhý prvek dvouprvkovou matici určuje možnost analýzy pro sloupec jako číslo od 1 do 9, uvedený výše.
- DecimalSeparator
Typ: System.Object
desítkové číslooddělovač , aplikace Excel používá při rozpoznávání čísla. Výchozí nastavení je nastavenísystému.
- ThousandsSeparator
Typ: System.Object
Tisíců oddělovač aplikace Excel používá při rozpoznávání čísla.Výchozí nastavení je nastavenísystému.
- TrailingMinusNumbers
Typ: System.Object
Čísla začínat znakem mínus.
Vrácená hodnota
Typ: System.Object
Poznámky
Následující tabulka zobrazuje výsledky importu textu pro různá nastavení importovat do aplikace Excel. Číselné výsledky jsou zobrazeny v pravém sloupci.
Systém desítkové číslo oddělovač |
oddělovačtisíců systému |
Hodnota desetinný oddělovač |
Tisíce oddělovač hodnot |
Původní text |
Hodnota buňky (datový typ) |
---|---|---|---|---|---|
Období |
Comma (Čárka) |
Comma (Čárka) |
Období |
123.123,45 |
123,123.45 (číselné) |
Období |
Comma (Čárka) |
Comma (Čárka) |
Comma (Čárka) |
123.123,45 |
123.123,45 (text) |
Comma (Čárka) |
Období |
Comma (Čárka) |
Období |
123,123.45 |
123,123.45 (číselné) |
Období |
Comma (Čárka) |
Období |
Comma (Čárka) |
123 123.45 |
123 123,45 (text) |
Období |
Comma (Čárka) |
Období |
Space (Mezera) |
123 123.45 |
123,123.45 (číselné) |
Volitelné parametry
Informace o volitelných parametrů, viz The Variable missing and Optional Parameters in Office Solutions.
Příklady
Následující kód například používá TextToColumns metoda převést prostor oddělený řetězec data v NamedRange do tří sloupců.
Tento příklad je přizpůsobení úrovni dokumentu.
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", missing],
"namedRange1");
namedRange1.Value2 = "01 01 2001";
Excel.Range destinationRange = this.Range["A5", missing];
namedRange1.TextToColumns(destinationRange,
Excel.XlTextParsingType.xlDelimited,
Excel.XlTextQualifier.xlTextQualifierDoubleQuote, missing,
missing, missing, missing, true, missing, missing, missing,
missing, missing, missing);
}
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.