Workbooks.OpenText Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Carrega e analisa um arquivo de texto como uma nova pasta de trabalho com uma única planilha que contém os dados de arquivo de texto analisados.

public void OpenText (string Filename, object Origin, object StartRow, object DataType, 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 TextVisualLayout, object DecimalSeparator, object ThousandsSeparator, object TrailingMinusNumbers, object Local);

Public Sub OpenText (Filename As String, Optional Origin As Object, Optional StartRow As Object, Optional DataType As Object, 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 TextVisualLayout As Object, Optional DecimalSeparator As Object, Optional ThousandsSeparator As Object, Optional TrailingMinusNumbers As Object, Optional Local As Object)

Parâmetros

Filename

String

String necessário. Especifica o nome do arquivo de texto a ser aberto ou analisado.

Origin

Object

Objeto opcional. Especifica a origem do arquivo de texto. Pode ser uma das seguintes XlPlatform constantes: xlMacintosh, xlWindows ou xlMSDOS. Adicionalmente, poderia ser um inteiro representando o número da página de código da página de código desejada. Por exemplo, "1256" especificaria que a codificação do arquivo de texto de origem é Árabe (Windows). Se esse argumento for omitido, o método usará a configuração atual da opção Origem do Arquivo no Assistente de Importação de Texto.

StartRow

Object

Objeto opcional. O número da linha na qual o texto começa a ser analisado. O valor padrão é 1.

DataType

Object

Objeto opcional. Especifica o formato da coluna dos dados no arquivo. Pode ser uma das seguintes XlTextParsingType constantes: xlDelimited ou xlFixedWidth. Se esse argumento não for especificado, o Microsoft Excel tentará determinar o formato da coluna quando abrir o arquivo.

TextQualifier

XlTextQualifier

Opcional XlTextQualifier. Especifica o qualificador do texto. Pode ser uma dessas XlTextQualifier constantes.xlTextQualifierDoubleQuotedefaultxlTextQualifierNonexlTextQualifierSingleQuote

ConsecutiveDelimiter

Object

Objeto opcional. True para ter delimitadores consecutivos considerados como um delimitador. O padrão é False.

Tab

Object

Objeto opcional. True para que o caractere de guia seja o delimitador (DataType deve ser xlDelimited). O valor padrão é False.

Semicolon

Object

Objeto opcional. True para que o caractere ponto-e-vírgula seja o delimitador (DataType deve ser xlDelimited). O valor padrão é False.

Comma

Object

Objeto opcional. True para que o caractere de vírgula seja o delimitador (DataType deve ser xlDelimited). O valor padrão é False.

Space

Object

Objeto opcional. True para que o caractere de espaço seja o delimitador (DataType deve ser xlDelimited). O valor padrão é False.

Other

Object

Objeto opcional. True para que o caractere especificado pelo OtherChar argumento seja o delimitador (DataType deve ser xlDelimited). O valor padrão é False.

OtherChar

Object

Objeto opcional (necessário se Other for True). Especifica o caractere delimitador quando Other é True. Se mais de um caractere for especificado, somente o primeiro caractere da cadeia de caracteres será usado; os caracteres restantes será ignorado.

FieldInfo

Object

Opcional XlColumnDataType. Uma matriz com informações de análise para colunas de dados individuais. A interpretação depende do valor de DataType. Quando os dados forem delimitados, esse argumento será uma matriz de matrizes de dois elementos, com cada matriz de dois elementos especificando as opções de conversão para uma coluna em particular. O primeiro elemento é o número de coluna (baseado em 1) e o segundo elemento é uma das constantesXlColumnDataType especificando como a coluna é analisada. xlGeneralFormat GeneralxlTextFormat TextxlMDYFormat MDY datexlDMYFormat DMY datexlYMDFormat YMD datexlMYDFormat MYD datexlDYMFormat DYM datexlYDMFormat YDM datexlEMDFormat EMD datexlSkipColumn Skip ColumnYou pode usar xlEMDFormat somente se você tiver instalado e selecionado suporte ao idioma taiwanês. A constante xlEMDFormat especifica que as datas da era taiwanesa estão sendo usadas. Os especificadores de coluna podem estar em qualquer ordem. Se não houver um especificador de coluna para uma coluna específica nos dados de entrada, a coluna será analisada com a configuração Geral. NotasSe você especificar que uma coluna deve ser ignorada, você deve declarar explicitamente o tipo para todas as colunas restantes ou os dados não serão analisados corretamente. Se houver uma data reconhecível nos dados, a célula será formatada como uma data na planilha, mesmo que a configuração da coluna seja Geral. Além disso, se você especificar um dos formatos de data acima para uma coluna e os dados não contiverem uma data reconhecida, o formato de célula na planilha será Geral.Se os dados de origem tiverem colunas de largura fixa, o primeiro elemento em cada matriz de dois elementos especificará a posição do caractere inicial na coluna (como um inteiro; o caractere 0 (zero) é o primeiro caractere). O segundo elemento da matriz de dois elementos especifica a opção de análise para a coluna como um número entre 0 e 9, como listado na tabela anterior.

TextVisualLayout

Object

Objeto opcional. O layout visual do texto.

DecimalSeparator

Object

Objeto opcional. O separador decimal que o Microsoft Excel usa ao reconhecer números. A configuração padrão é a configuração do sistema.

ThousandsSeparator

Object

Objeto opcional. O separador de milhares que o Excel usa ao reconhecer números. A configuração padrão é a configuração do sistema. A tabela a seguir mostra os resultados da importação de texto para o Excel para várias configurações de importação. Os resultados numéricos são exibidos na coluna mais à direita.

TrailingMinusNumbers

Object

Objeto opcional.

Local

Object

Objeto opcional.