Metodo NamedRange.TextToColumns

Articolo
08/11/2011

Analizza una colonna di celle che contengono testo in diverse colonne.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
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
)

Parametri

Destination
Tipo: System.Object
Oggetto Microsoft.Office.Interop.Excel.Range che specifica la posizione di memorizzazione dei risultati in Microsoft Office Excel.Se l'intervallo include più di una cella, verrà utilizzata la cella superiore sinistra.

DataType
Tipo: Microsoft.Office.Interop.Excel.XlTextParsingType
Formato del testo da dividere in colonne.
Può essere una delle seguenti costanti di XlTextParsingType:
xlDelimited (impostazione predefinita)
xlFixedWidth

TextQualifier
Tipo: Microsoft.Office.Interop.Excel.XlTextQualifier
Può essere uno dei seguenti valori di XlTextQualifier:
xlTextQualifierDoubleQuote (impostazione predefinita)
xlTextQualifierNone
xlTextQualifierSingleQuote

ConsecutiveDelimiter
Tipo: System.Object
true affinché i delimitatori consecutivi in Excel vengano considerati come un unico delimitatore.Il valore predefinito è false.

Tab
Tipo: System.Object
true affinché DataType sia impostato su xlDelimited e il carattere di tabulazione sia un delimitatore.Il valore predefinito è false.

Semicolon
Tipo: System.Object
true affinché DataType sia impostato su xlDelimited e il punto e virgola sia un delimitatore.Il valore predefinito è false.

Comma
Tipo: System.Object
true affinché DataType sia impostato su xlDelimited e la virgola sia un delimitatore.Il valore predefinito è false.

Space
Tipo: System.Object
true affinché DataType sia impostato su xlDelimited e lo spazio sia un delimitatore.Il valore predefinito è false.

Other
Tipo: System.Object
true affinché DataType sia impostato su xlDelimited e il carattere specificato dall'argomento OtherChar sia un delimitatore.Il valore predefinito è false.

OtherChar
Tipo: System.Object
Carattere delimitatore quando l'argomento Other è impostato su true.Se si specifica più di un carattere, verrà utilizzato solo il primo carattere della stringa, mentre i restanti caratteri verranno ignorati.

FieldInfo
Tipo: System.Object
Matrice contenente informazioni di analisi per le singole colonne di dati.L'interpretazione dipende dal valore dell'argomento DataType.Quando i dati sono delimitati, questo argomento è una matrice in forma di matrici a due elementi, in cui ciascuna matrice a due elementi specifica le opzioni di conversione per una colonna specifica.Il primo elemento corrisponde al numero di colonna (in base 1), mentre il secondo a una delle costanti di XlColumnDataType che specifica la modalità di analisi della colonna.
Può essere uno dei seguenti valori di XlColumnDataType:
xlGeneralFormat
xlTextFormat
xlMDYFormat
xlDMYFormat
xlYMDFormat
xlMYDFormat
xlDYMFormat
xlYDMFormat
xlEMDFormat
xlSkipColumn
È possibile utilizzare xlEMDFormat solo se è stata selezionata o installata la lingua taiwanese.Specificare xlEMDFormat se si desidera utilizzare le date del calendario taiwanese.
Gli identificatori di colonna possono essere in qualsiasi ordine.Se un dato identificatore di colonna non è presente per una colonna specifica nei dati di input, la colonna verrà analizzata con l'impostazione xlGeneralFormat.
Se i dati di origine contengono colonne a larghezza fissa, il primo elemento di ciascuna matrice a due elementi specifica la posizione del carattere di inizio nella colonna (come intero di cui 0 (zero) è il primo carattere).Il secondo elemento della matrice a due elementi specifica l'opzione di analisi per la colonna sotto forma di numero compreso tra 1 e 9, come indicato di seguito.

DecimalSeparator
Tipo: System.Object
Separatore decimale utilizzato in Excel nel riconoscimento dei numeri.L'impostazione predefinita è quella di sistema.

ThousandsSeparator
Tipo: System.Object
Separatore delle migliaia utilizzato in Excel nel riconoscimento dei numeri.L'impostazione predefinita è quella di sistema.

TrailingMinusNumbers
Tipo: System.Object
Numeri che iniziano con il carattere meno (-).

Valore restituito

Tipo: System.Object

Note

Nella tabella riportata di seguito sono illustrati i risultati dell'importazione di testo in Excel per diverse impostazioni di importazione. I risultati numerici vengono visualizzati nella colonna all'estrema destra.

Separatore decimale di sistema	Separatore delle migliaia di sistema	Valore del separatore decimale	Valore del separatore delle migliaia	Testo originale	Valore di cella (tipo dati)
Punto	Virgola	Virgola	Punto	123.123,45	123,123.45 (numerico)
Punto	Virgola	Virgola	Virgola	123.123,45	123.123,45 (testo)
Virgola	Punto	Virgola	Punto	123,123.45	123,123.45 (numerico)
Punto	Virgola	Punto	Virgola	123 123.45	123 123.45 (testo)
Punto	Virgola	Punto	Spazio	123 123.45	123,123.45 (numerico)

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito viene utilizzato il metodo TextToColumns per convertire in tre colonne una stringa di data delimitata da spazi all'interno di un controllo NamedRange.

Questo esempio è valido per una personalizzazione a livello di documento.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Share via