Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Criar Linha com

valor

Conteú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âmetroNomeTipoDoc
Parâmetro 1AbaStringRecebe a variável que usamos para criar a aba da planilha
Parâmetro 2Número da LinhaStringRecebe o
valor
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 3ConteúdoStringDetermina qual o
valor
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

Aba.

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 3Figura 1 - Bloco Linha com valor

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 Ade A:1.

Informações
titleMais sobre

 Consulte a documentação de suporte do Excel para quaisquer dúvidas.


Informações
titleBloco Criar Linha

Uma outra alternativa para o bloco Criar Linha com Conteúdo, é o bloco Criar Linha,