Comando
WorksheetRows()
Lê todas as linhas da planilha Excel ativa (UsedRange) e carrega em uma variável de lista. Utilizado como fonte de dados para o Foreach(), iterando linha por linha. Colunas são acessíveis pelo índice de letra (A, B, C...) correspondente à coluna na planilha.
Propriedades disponíveis dentro do Foreach:
O índice de linha começa em 1 (inclui a linha de cabeçalho se houver). O UsedRange do Excel determina quantas linhas e colunas são lidas — células fora do UsedRange não são incluídas.
Propriedades disponíveis dentro do Foreach:
$variavel.Count: total de linhas no UsedRange$variavel.A, $variavel.B : valor da célula na coluna A, B, C...O índice de linha começa em 1 (inclui a linha de cabeçalho se houver). O UsedRange do Excel determina quantas linhas e colunas são lidas — células fora do UsedRange não são incluídas.
WorksheetRows(variavel [, appId])Parâmetros
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
variavel | Sim | Nome da variável de lista. Deve começar com $. Ex: $linhas. |
appId | Não | Identificador da instância Excel gerenciada (definido no OpenExcel). Se omitido, usa a primeira instância disponível. |
Exemplos
// Iterar todas as linhas da planilha ativa:
OpenExcel(@'C:\dados\planilha.xlsx', '', 'xls')
WorksheetRows($linhas, 'xls')
Output('Total de linhas: ' + $linhas.Count)
Foreach ($linhas) {
// Acessar colunas pela letra da coluna Excel (A, B, C...):
string $nome = $linhas.A
string $email = $linhas.B
string $valor = $linhas.C
AthusDBInsert('tbc_clientes', '$nome, $email, $valor')
}
CloseExcel('xls')