Condividi tramite


XmlMappedRange.TextToColumns Metodo

Definizione

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

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

Parametri

Destination
Object

Oggetto Range che specifica la posizione di memorizzazione dei risultati in Microsoft Office Excel. Se l'intervallo è superiore a una singola cella, verrà utilizzata la cella superiore sinistra.

DataType
XlTextParsingType

Formato del testo da dividere in colonne. Può essere una delle costanti seguenti XlTextParsingType : xlDelimited (impostazione predefinita) xlFixedWidth

TextQualifier
XlTextQualifier

Può essere uno dei valori seguenti XlTextQualifier : xlTextQualifierDoubleQuote (impostazione predefinita) xlTextQualifierNonexlTextQualifierSingleQuote

ConsecutiveDelimiter
Object

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

Tab
Object

true per avere DataTypexlDelimited e per avere il carattere di tabulazioni un delimitatore. Il valore predefinito è false.

Semicolon
Object

trueDataType deve essere xlDelimited e avere il punto e virgola come delimitatore. Il valore predefinito è false.

Comma
Object

true per avere DataTypexlDelimited e avere la virgola come delimitatore. Il valore predefinito è false.

Space
Object

true per avere DataTypexlDelimited e per avere il carattere di spazio essere un delimitatore. Il valore predefinito è false.

Other
Object

true per avere DataTypexlDelimited e avere il carattere specificato dall'argomento OtherChar come delimitatore. Il valore predefinito è false.

OtherChar
Object

Carattere delimitatore quando Other è true. Se si specifica più di un carattere, verrà utilizzato solo il primo carattere della stringa, mentre i restanti caratteri verranno ignorati.

FieldInfo
Object

Matrice contenente informazioni di analisi per le singole colonne di dati. L'interpretazione dipende dal valore di 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 è il numero di colonna (basato su 1) e il secondo elemento è una delle XlColumnDataType costanti che specificano come viene analizzata la colonna. Può essere uno dei valori seguentiXlColumnDataType:xlTextFormatxlDMYFormatxlYMDFormatxlMYDFormatxlMDYFormatxlGeneralFormatxlYDMFormatxlEMDFormatxlDYMFormatxlSkipColumn è possibile usare xlEMDFormat solo se il supporto linguistico taiwanese è installato e selezionato. xlEMDFormat specifica che le date dell'era taiwanese vengono usate. 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
Object

Separatore decimale utilizzato in Excel nel riconoscimento dei numeri. L'impostazione predefinita è quella di sistema.

ThousandsSeparator
Object

Separatore delle migliaia utilizzato in Excel nel riconoscimento dei numeri. L'impostazione predefinita è quella di sistema.

TrailingMinusNumbers
Object

Numeri che iniziano con il carattere meno (-).

Restituisce

Esempio

Nell'esempio di codice seguente viene usato il TextToColumns metodo per convertire una stringa di data delimitata da spazi all'interno di un oggetto XmlMappedRange in tre colonne. In questo esempio di codice si presuppone che il foglio di codice corrente contenga un oggetto XmlMappedRange denominato CustomerLastNameCell .

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

Commenti

La tabella seguente illustra i risultati dell'importazione del testo in Excel per varie impostazioni di importazione. I risultati numerici vengono visualizzati nella colonna più a destra.

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

Parametri facoltativi

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

Si applica a