activities
latest
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Atividades de produtividade

Última atualização 14 de jan de 2026

Read Range Workbook

UiPath.Excel.Activities.ReadRange

Description

Lê o valor de um intervalo do Excel e o armazena em uma variável TabelaDeDados. Se o intervalo não for especificado, a planilha inteira será lida. Se o intervalo for especificado como uma célula, a planilha inteira a partir dessa célula é lida.

Observação:

Os formatos de pasta de trabalho suportados são .xls, .xlsm, .xltm, .xlsx e .xltx.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Propriedades

Comum

  • DisplayName - O nome de exibição da atividade.
Entrada
  • Intervalo - Especifica o intervalo de células a ser lido. Se esse valor não for especificado, a planilha inteira é lida. Se o valor consistir de apenas uma célula, a planilha inteira é lida, a partir daquela célula. Apenas strings e variáveis String são compatíveis.
Observação:

Strings devem ser colocadas entre aspas.

  • SheetName - The name of the sheet in which the range that you want to read is. By default, this is filled in with "Sheet1." Only String variables and strings are supported.
  • Caminho da pasta de trabalho - O caminho completo da planilha do Excel que você deseja usar. Esse campo aceita entrada IResource. Use o botão de adição para alternar o modo de entrada entre Arquivo local e Recurso de arquivo. Se o arquivo do Excel a ser usado estiver localizado na pasta do projeto, seu caminho relativo pode ser usado. Apenas strings e variáveis String são compatíveis.
Observação:

Alternativamente, em vez de fornecer o caminho para o arquivo, você pode melhorar o desempenho do runtime ao usar várias atividades de Pasta de trabalho com o mesmo arquivo, conectando o projeto ao arquivo a partir do Data Manager e, em seguida, fazer referência a ele usando a propriedade Pasta de trabalho .

Diversos

  • Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.
Opções
  • AdicionarCabeçalhos - Quando estiver selecionado, os cabeçalhos das colunas do intervalo especificado da planilha também são extraídos. Por padrão, essa caixa de seleção fica desmarcada.
  • Senha - A senha da pasta de trabalho do Excel, se necessário. Apenas strings e variáveis String são compatíveis.
  • PreservarFormato - Selecione essa opção para ler os valores, conforme eles são exibidos no intervalo (por exemplo moeda, data, texto). A formatação de número real não é mantida, apenas a maneira como os dados são exibidos. Por padrão, a opção fica desmarcada.
Saída
  • TabelaDeDados - Armazena os dados extraídos do intervalo especificado do Excel em uma variável Tabela de dados. Apenas variáveis Tabela de dados são compatíveis.
Usar pasta de trabalho
  • Pasta de trabalho — selecione um recurso de pasta de trabalho no menu Mais . Disponível se você adicionou o arquivo do Excel como um recurso, conectando-se à pasta de trabalho a partir do Data Manager. Adicionar um recurso de pasta de trabalho e, em seguida, fazer referência ao recurso em várias atividades de pasta de trabalho garante que o arquivo não seja recarregado na memória para cada operação, melhorando o desempenho do runtime, especialmente ao trabalhar com arquivos grandes. Para obter mais informações, consulte Como usar o Data Manager.
  • Description
  • Compatibilidade do projeto
  • Propriedades

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo
Confiança e segurança
© 2005-2026 UiPath. Todos os direitos reservados.