Obter
ValorConteúdo da Célula
Obtém o valor conteúdo de uma célula da planilha Excel.
Parâmetros
Parâmetro | Nome | Doc | Tipo |
|---|---|---|---|
| Parâmetro 1 | Número da Linha | String | 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 2 | Número da Coluna | String | Número da coluna |
| na planilha. Os valores inseridos neste campo são numéricos, começando sempre com 0 (equivalente a "A", como é no Excel padrão). | |||
| Parâmetro 3 | Aba | String | Aba da planilha. |
Retorno
Retorna o conteúdo da célula selecionada.
Compatibilidade
Servidor
Exemplo
A função "criarSheet" (Figura 1) contém todos os blocos desde a criação até o salvamento do arquivo.
Na função abaixo, o objeto da planilha é criado na variável “novo”, com o bloco Criar Planilha Excel, em seguida, a aba (worksheet) “Aba1“ é inserida no objeto da planilha utilizando o bloco Criar Aba. O bloco Inserir Valor na Célula insere na o valor "Exemplo" na célula "0:0", equivalente a "A1" no Excel.
A variável "obter" recebe o retorno do bloco Obter Conteúdo da Célula que está configurado da seguinte forma: os Assim, ela inicia com a variável "arquivo" recebendo o bloco Criar Arquivo Excel, no qual cria a pasta de trabalho Excel. A variável "planilha" recebe o bloco Criar Sheet, no qual cria a planilha. O bloco Inserir Valor na Célula insere na célula 0:0 o valor "valor obtido". Em seguida, a variável "obter" é atribuída ao bloco Obter Valor, o qual recebe nos parâmetros Número da Linha e Número da Coluna recebem, respectivamente, o valor 0:0 e no parâmetro Sheet "0" (equivalente a célula "A1" no Excel) e no parâmetro Aba, a variável "planilhaaba". Em seguida, o bloco imprime mostrará o conteúdo da variável "obter" no console. Como o arquivo Excel será criado na memória, o bloco Salvar Arquivo Excel salva o arquivo na pasta da aplicação e o arquivo pode ser baixado na raiz do projeto.
O bloco imprimir foi utilizado para exibir o resultado da execução do bloco no Console do depurador.
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.
Figura 1 - Bloco Obter Conteúdo da célula
Na figura abaixo vemos a execução da função da figura 1, o bloco Obter Conteúdo da Célula retornou o valor adicionado pelo bloco Inserir Valor na Célula.
Figura 2 - Resultado do bloco Obter Conteúdo Figura 1 - Obtendo valor da célula
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.
| Informações | ||
|---|---|---|
| ||
Consulte a documentação de suporte do Excel para quaisquer dúvidas. |