Comando
CsvFile()
Lê um arquivo CSV (ou texto delimitado) e carrega as linhas em uma variável de lista. Utilizado como fonte de dados para o Foreach(), iterando linha a linha. Cada linha é dividida em colunas pelo separador informado.
Propriedades disponíveis dentro do Foreach:
Propriedades disponíveis dentro do Foreach:
$variavel.Count: total de linhas$variavel.Line: linha atual completa (texto bruto)$variavel.Columns: número de colunas da linha atual$variavel.$field1, $variavel.$field2: colunas individuais (1-based)
CsvFile(variavel, caminho, separador, header)Parâmetros
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
variavel | Sim | Nome da variável de lista. Deve começar com $. Ex: $dados. |
caminho | Sim | Caminho completo do arquivo CSV. |
separador | Sim | Caractere separador de colunas. Ex: '|', ';', ','. |
header | Sim | true: ignora a primeira linha (cabeçalho). |
Exemplos
// CSV com pipe como separador, sem cabeçalho:
CsvFile($dados, @'C:\entrada\clientes.csv', '|', false)
Output($dados.Count + ' registros encontrados')
Foreach ($dados) {
Output($dados.$field1 + ' - ' + $dados.$field2)
}Observações
Linhas em branco são ignoradas automaticamente. O arquivo é lido integralmente em memória antes do Foreach.