Compartilhar via


Inicializando o driver de Fonte de Dados de Texto

Aplica-se ao: Access 2013, Office 2013

O mesmo driver de banco de dados é usado para fontes de dados de texto e para fontes de dados HTML.

Quando você instala o driver de banco de dados fonte de texto, o programa de instalação grava um conjunto de valores padrão no Registro do Microsoft Windows nas subchaves Mecanismos e Formatos ISAM. Você não deve modificar essas configurações diretamente; use o programa de instalação de seu aplicativo para adicionar, remover ou alterar essas configurações. As seções a seguir descrevem a inicialização e as configurações do ISAM Format no driver de banco de dados da fonte de dados de texto.

Configurações de inicialização de fonte de dados de texto

A pasta Access Connectivity Engine\ISAM Formats\Text inclui configurações de inicialização do driver Acetxt.dll, usado para acesso externo ao arquivos de dados de texto. As configurações normais das entradas nessa pasta são mostradas no exemplo a seguir.

    win32=<path>\ ACETXT.DLL 
    
    MaxScanRows=25 
    
    FirstRowHasNames=True 
    
    CharacterSet= ANSI 
    
    Format=CSVDelimited 
    
    Extensions= txt,csv,tab,asc 
    
    ExportCurrencySymbols=Yes

O mecanismo de banco de dados do Microsoft Access usa as entradas da pasta Text da seguinte maneira:

Entrada

Descrição

win32

A localização do arquivo Acetxt.dll. O caminho completo é determinado no momento da instalação. Os valores são do tipo REG_SZ.

MaxScanRows

O número de linhas a serem verificadas ao determinar os tipos de coluna. Se for 0, o arquivo inteiro será pesquisado. O padrão é 25. Os valores são do tipo REG_DWORD.

FirstRowHasNames

Um valor binário que indica se a primeira linha da tabela contém nomes de coluna. Um valor 0 indica que, durante a importação, os nomes de coluna serão extraídos da primeira linha.

Characterset

Um indicador de como as páginas de texto são armazenadas. As configurações possíveis são:

  • ANSI — a página de código ANSI do computador. São feitas as conversões AnsiToUnicode e UnicodeToAnsi.

  • OEM — a página de código OEM do computador. São feitas as conversões OemToUnicode e UnicodeToOem.

  • Unicode — não são feitas conversões de página de código.

  • <número> decimal – o número da página de código de um conjunto de caracteres específico. As conversões de e para Unicode serão feitas.

O padrão é ANSI. Os valores são do tipo REG_SZ.

Formatar

Pode ser qualquer um dos seguintes: TabDelimited, CSVDelimited, Delimitado (<caractere> único). O delimitador de um caractere no formato Delimited pode ser qualquer caractere com exceção de aspas ("). O padrão é CSVDelimited. Os valores são do tipo REG_SZ.

Extensões

A extensão de qualquer arquivo a ser pesquisado ao procurar dados baseados em texto. O padrão é txt, csv, tab, asc. Os valores são do tipo REG_SZ.

ExportCurrencySymbols

Um valor binário que indica se o símbolo de moeda apropriado é incluído quando os campos de moeda são exportados. Um valor 01 indica que o símbolo é incluído. Um valor 00 indica que apenas os dados numéricos são exportados. O valor padrão é 01. Os valores são do tipo REG_BINARY.

Formatos ISAM de fonte de dados de texto

A pasta Access Connectivity Engine\ISAM Formats\Text contém as entradas a seguir.

Nome da entrada

Tipo

Valor

Motor

REG_SZ

Texto

ExportFilter

REG_SZ

Arquivos de texto (*.txt; *.csv; *.tab; *.asc)

ImportFilter

REG_SZ

Arquivos de texto (*.txt; *.csv; *.tab; *.asc)

CanLink

REG_BINARY

01

OneTablePerFile

REG_BINARY

01

IsamType

REG_DWORD

2

IndexDialog

REG_BINARY

00

CreateDBOnExport

REG_BINARY

00

ResultTextImport

REG_SZ

Importar dados do arquivo externo para o banco de dados atual. Alterar dados no banco de dados atual não os alterará no arquivo externo.

ResultTextLink

REG_SZ

Criar uma tabela no banco de dados atual vinculada ao arquivo externo. Alterar dados no banco de dados atual não os alterará no arquivo externo.

ResultTextExport

REG_SZ

Exportar dados do banco de dados atual para um arquivo de texto. Esse processo substituirá os dados quando exportados para um arquivo já existente.

SupportsLongNames

REG_BINARY

01

Observação

[!OBSERVAçãO] When you change Windows Registry settings, you must exit and then restart the database engine for the new settings to take effect.

Formatos ISAM de importação de HTML

A pasta Access Connectivity Engine\ISAM Formats\HTML Import contém as entradas a seguir.

Nome da entrada

Tipo

Valor

Motor

REG_SZ

Texto

ImportFilter

REG_SZ

Arquivos HTML (*.ht*)

CanLink

REG_BINARY

01

OneTablePerFile

REG_BINARY

00

IsamType

REG_DWORD

2

IndexDialog

REG_BINARY

00

CreateDBOnExport

REG_BINARY

00

ResultTextImport

REG_SZ

Importar dados do arquivo externo para o banco de dados atual. Alterar dados no banco de dados atual não os alterará no arquivo externo.

ResultTextLink

REG_SZ

Criar uma tabela no banco de dados atual vinculada ao arquivo externo. Alterar dados no banco de dados atual não os alterará no arquivo externo.

SupportsLongNames

REG_BINARY

01

Observação

[!OBSERVAçãO] When you change Windows Registry settings, you must exit and then restart the database engine for the new settings to take effect.

Formatos ISAM de exportação html

A pasta Access Connectivity Engine\ISAM Formats\HTML Export contém as entradas a seguir.

Nome da entrada

Tipo

Valor

Motor

REG_SZ

Texto

ExportFilter

REG_SZ

Arquivos HTML (*.htm)

CanLink

REG_BINARY

00

OneTablePerFile

REG_BINARY

01

IsamType

REG_DWORD

2

IndexDialog

REG_BINARY

00

CreateDBOnExport

REG_BINARY

00

ResultTextExport

REG_SZ

Exportar dados do banco de dados atual para um arquivo de texto. Esse processo substituirá os dados quando exportados para um arquivo já existente.

SupportsLongNames

REG_BINARY

01

Observação

[!OBSERVAçãO] When you change Windows Registry settings, you must exit and then restart the database engine for the new settings to take effect.

Personalizando o arquivo Schema.ini para dados de texto e HTML

Para ler, importar ou exportar dados HTML e de texto, você precisa criar um arquivo Schema.ini, bem como incluir as informações ISAM do texto no arquivo .ini. O arquivo Schema.ini contém informações específicas da fonte de dados: como o arquivo de texto está formatado, como ele é lido no momento da importação e o formato de exportação padrão dos arquivos. Os exemplos a seguir mostram o layout de um arquivo de largura fixa, Filename.txt:

    [Filename.txt] 
    
    ColNameHeader=False 
    
    Format=FixedLength 
    
    FixedFormat= RaggedEdge 
    
    MaxScanRows=25 
    
    CharacterSet=OEM 
    
    Col1=columnname Char Width 24 
    
    Col2=columnname2 Date Width 9 
    
    Col3=columnname7 Float Width 10 
    
    Col4=columnname8 Integer Width 10 
    Col5=columnname9 LongChar Width 10

Da mesma maneira, o formato de um arquivo delimitado é especificado assim:

    [Delimit.txt] 
    
    ColNameHeader=True 
    
    Format=Delimited() 
    
    MaxScanRows=0 
    
    CharacterSet=OEM 
    
    Col1=username char width 50 
    
    Col2=dateofbirth Date width 9

Se estiver exportando dados para um arquivo de texto delimitado, especifique o formato desse arquivo também:

    [Export: My Special Export] 
    
    ColNameHeader=True 
    
    Format=TabDelimited 
    
    MaxScanRows=25 
    
    CharacterSet=OEM 
    
    DateTimeFormat=mm.dd.yy.hh.mm.ss 
    
    CurrencySymbol=Dm 
    
    CurrencyPosFormat=0 
    
    CurrencyDigits=2 
    
    CurrencyNegFormat=0 
    
    CurrencyThousandSymbol=, 
    
    CurrencyDecimalSymbol=. 
    
    DecimalSymbol=, 
    
    NumberDigits=2 
    
    NumberLeadingZeros=0 
    
    TextDelimeter="

O exemplo My Special Export refere-se a uma opção de exportação específica; você pode determinar qualquer variação das opções de exportação no momento da conexão. Este último exemplo também corresponde ao nome da fonte de dados (DSN) que pode ser opcionalmente passado no momento da conexão. Todas as três seções de formato podem ser incluídas no arquivo .ini.

O mecanismo de banco de dados do Microsoft Access usa as entradas do Schema.ini da seguinte maneira:

Entrada

Descrição

ColNameHeader

Pode ser True (indicando que o primeiro registro dos dados especifica os nomes das colunas) ou False.

Formatar

Pode ser definido como um dos seguintes valores: TabDelimited, CSVDelimited, Delimitado (<caractere> único) ou FixedLength. O delimitador especificado para o formato de arquivo delimitado pode ser qualquer caractere com exceção de aspas (").

FixedFormat

Usado somente quando Format é FixedLength; pode ser definido como: RaggedEdge ou TrueFixedLength. RaggedEdge permite que as linhas terminem com um caractere de retorno de carro. TrueFixedLength exige que cada linha tenha um número exato de caracteres e qualquer caractere de retorno de carro que não estiver no limite da linha será considerado incorporado ao campo. Se essa configuração não estiver presente, o valor padrão será RaggedEdge.

MaxScanRows

Indica o número de linhas a serem verificadas ao determinar os tipos de dados da coluna. Se estiver definido como 0, o arquivo inteiro será pesquisado.

Characterset

Pode ser definido como OEM, ANSI, UNICODE ou o número decimal de uma página de código válida e indica o conjunto de caracteres do arquivo de origem.

Datetimeformat

Pode ser definida como uma cadeia de caracteres de formatação indicando datas e horas. Essa entrada deverá ser especificada se todos os campos de data/hora na importação/exportação forem tratados como sendo do mesmo formato. Há suporte para todos os formatos do mecanismo de banco de dados Microsoft Jet, com exceção de AM e PM. Na ausência de uma cadeia de caracteres de formatação, as opções de data e hora curtas do Painel de Controle do Windows serão usadas.

CurrencySymbol

Indica o símbolo de moeda a ser usado nos valores de moeda do arquivo de texto. Os exemplos incluem o símbolo do dólar ($) e Dm. Na ausência dessa entrada, o valor padrão do Painel de Controle do Windows será usado.

CurrencyPosFormat

Pode ser definido como qualquer um dos seguintes valores: Conversor de Moedas prefixo de símbolo sem separação (US$ 1) Conversor de Moedas sufixo de símbolo sem separação (1$) Conversor de Moedas prefixo de símbolo com uma separação de caractere (US$ 1) Conversor de Moedas sufixo de símbolo com uma separação de caractere (1 $) Se essa entrada estiver ausente, o valor padrão no Windows Painel de Controle será usado.

CurrencyDigits

Especifica o número de dígitos usados na parte fracional do valor da moeda. Na ausência dessa entrada, o valor padrão do Painel de Controle do Windows será usado.

CurrencyNegFormat

Pode ser um dos seguintes valores: ($1) –$1 $-1 $1– (1$) –1$ 1 a $ 1$– –1 $ –$ 1 $– $1– $–1– $–1– $ ($ 1) ($ 1) ($) (1 $) O sinal de dólar é mostrado para fins deste exemplo, mas deve ser substituído pelo valor currencySymbol apropriado no programa real. Na ausência dessa entrada, o valor padrão do Painel de Controle do Windows será usado.

CurrencyThousandSymbol

Indica o símbolo de um caractere a ser usado para separar os milhares dos valores de moeda no arquivo de texto. Na ausência dessa entrada, o valor padrão do Painel de Controle do Windows será usado.

CurrencyDecimalSymbol

Pode ser definido como qualquer caractere usado para separar a parte fracional do valor da moeda. Na ausência dessa entrada, o valor padrão do Painel de Controle do Windows será usado.

DecimalSymbol

Pode ser definido como qualquer caractere usado para separar o inteiro da parte fracional de um número. Na ausência dessa entrada, o valor padrão do Painel de Controle do Windows será usado.

NumberDigits

Indica o número de dígitos decimais usados na parte fracional de um número. Na ausência dessa entrada, o valor padrão do Painel de Controle do Windows será usado.

NumberLeadingZeros

Especifica se um valor decimal inferior a 1 e superior a –1 deve conter zeros à esquerda; esse valor pode ser False (sem zeros à esquerda) ou True.

Col1, Col2, ...

Lista as colunas do arquivo de texto que devem ser lidas. O formato dessa entrada deve ser: Coln=columnName type [Width #] columnName: nomes de coluna com espaços inseridos devem ser colocados entre aspas. type: pode ser Bit, Byte, Short, Long, Decimal, Currency, Single, Double, DateTime. Binary, OLE, Text ou Memo. Além disso, há suporte para os seguintes tipos de Driver de Texto ODBC: Char (mesmo que Texto) Float (mesmo que Double) Inteiro (mesmo que Short) LongChar (mesmo que Memorando) Formato de data de data No caso de um tipo de memorando, um marcador de formato adicional [Attribute Hyperlink] pode ser usado para especificar colunas que devem ser URLs ativas no Microsoft Access. No caso de um tipo Decimal, marcadores de formato adicionais [Scale #] Precision #] devem ser usados.

TextDelimiter

Pode ser qualquer caractere usado para delimitar cadeias de caracteres que contenham qualquer um dos outros caracteres especiais. Por exemplo, "abc", "xyz,pqr", "hij" Se essa entrada não estiver presente, o delimitador padrão será uma citação dupla. Se essa entrada for a cadeia de caracteres "none", nenhum caractere será tratado como delimitador.

Observação

[!OBSERVAçãO] Ao alterar as configurações do arquivo Schema.ini, você deve fechar e reiniciar o mecanismo de banco de dados para que as novas configurações entrem em vigor.