Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Criar Linha com
valorConteúdo
Insere Cria uma linha com valor na célula de uma planilha Excel. Esse valor será inserido apenas na primeira coluna.
Parâmetros
Parâmetro | Nome | Tipo | Doc |
---|---|---|---|
Parâmetro 1 | Aba | String | Recebe a variável que usamos para criar a aba da planilha |
Parâmetro 2 | Número da Linha | String | Recebe o |
número da linha na planilha, começando sempre com o valor zero, ao invés de 1, como é no Excel padrão. | |||
Parâmetro 3 | Conteúdo | String | Determina qual o |
conteúdo será inserido na linha |
Compatibilidade
Servidor
Exemplo 1
A função Inserir (Figura 1) contém todos os blocos desde a criação até o salvamento do arquivo.
Assim, ela inicia recebendo na variável "novo" Na função abaixo, o objeto da planilha é criado na variável “novo” com o bloco Criar Arquivo Planilha Excel, em seguida, a variável "planilha1" recebe aba (worksheet) “Aba1“ é inserida no objeto da planilha utilizando o bloco Criar Sheet, o qual criará a planilha. Após isso, inserimos o bloco Linha com valor no parâmetro Sheet inserimos a variável "planilha1" que usamos para criar a planilha, após isso determinamos qual linha iremos inserir o valor com o parâmetro Número da Linha, onde inserimos o número "0", após isso, , em seguida, arrastamos o bloco de texto para a variável Valor e escrevemos "NovoValor" que será o valor inserido na linha que definimos (Figura 2), por último, o bloco Salvar Arquivo Excel salva o arquivo na pasta da aplicação e o arquivo pode ser baixado na raiz do projeto.
Image Removed
Figura 1 - Bloco Linha com valorAba.
Utilizamos o bloco Criar Linha com Conteúdo e no parâmetro Aba inserimos a variável "aba", em seguida, determinamos no parâmetro Número da Linha que iremos inserir o valor na linha 0 (equivalente a linha 1 no Excel) e no parâmetro Conteúdo informamos o texto "NovoValor". Ao final, utilizamos o bloco Salvar Planilha Excel, passando o objeto criado “novo”, o nome do arquivo da planilha e o endereço onde será salvo.
Image Added
Figura 1 - Bloco Criar Linha com Conteúdo
A execução da função da figura 1 pode ser vista na figura 2.
Image Added
Figura 2 - Valor inserido na linha criada
Exemplo 2
No exemplo da figura 3, inserimos o bloco Criar Linha com Conteúdo logo após o bloco Inserir Conteúdo na Célula, passando nos parâmetros Número da Linha e Número da Coluna o valor "0", respectivamente. O resultado disso pode ser observado na figura 4, o conteúdo do bloco Inserir Conteúdo na Célula foi sobrescrito pelo conteúdo do bloco Criar Linha com Conteúdo, a mesma ação ocorreria se os blocos estivessem em posições opostas, mas isso só ocorreu porque passamos o mesmo valor para o parâmetro Número da Linha.
Image Added
Figura 3 - Bloco Criar Linha com Conteúdo sobrescrevendo conteúdo do bloco anterior
Image Added
Figura 4 - Resultado da execução da figura 3
Sobre o bloco
Diferente da manipulação direta de uma célula em um arquivo Excel, as coordenadas das células são apenas numéricas, sendo que a primeira célula se acessa com o valor 0:0 em vez de A:1. Consulte a documentação de suporte do Excel para quaisquer dúvidas.
Informações | ||
---|---|---|
| ||
Uma outra alternativa para o bloco Criar Linha com Conteúdo, é o bloco Criar Linha, |