XmlMappedRange.TextToColumns Metodo

Definizione

Spazio dei nomi:

Microsoft.Office.Tools.Excel

Assembly:

Microsoft.Office.Tools.Excel.dll

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

Object

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.