Microsoft Excel métodos do conector
Os métodos de conector Microsoft Excel executam várias ações em documentos Microsoft Excel. Em um fluxo de automação, os métodos são conectados a outros métodos e componentes. Para usar os métodos, você deve primeiro expô-los.
Aberto
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Caminho do arquivo |
Caminho para o arquivo existente que o método abre. Para criar um arquivo, você deve definir o valor do parâmetro CreateNewFile como verdadeiro. Nota:
O caminho deve conter o nome do arquivo. |
Dados em | Cadeia de caracteres |
| CriarNovoArquivo | Especifica se um novo arquivo do Excel deve ser criado se o arquivo especificado não existir. Se o parâmetro CreateNewFile estiver definido como verdadeiro, um novo arquivo será criado no caminho de arquivo especificado. Se definido como falso, ele tentará abrir o Excel a partir do caminho de arquivo fornecido. |
Dados em | Booliano |
| Exibir Alertas | Especifica se o Excel exibe alertas ou avisos durante o processo de abertura. Se definido como verdadeiro, o Excel exibirá alertas para problemas como conflitos de arquivo ou avisos de compatibilidade. Se definido como falso, esses alertas serão suprimidos. |
Dados em | Booliano |
| Está visível | Especifica se a janela da aplicação Excel fica visível para o usuário quando o arquivo é aberto ou não. Se definido como verdadeiro, a janela do Excel será exibida na tela. Se definido como falso, o Excel será executado em segundo plano sem uma interface visível. |
Dados em | Booliano |
| ModoSomenteLeitura | Especifica se o arquivo do Excel deve ser aberto no modo somente leitura. Se definido como verdadeiro, o arquivo será aberto no modo somente leitura, evitando que sejam feitas mudanças. Se definido como falso, o arquivo será aberto no modo normal, permitindo modificações. |
Dados em | Booliano |
| Senha | Senha necessária para abrir o arquivo do Excel se ele estiver protegido por senha. Se o arquivo não estiver protegido por senha, este parâmetro poderá ser deixado em branco. |
Dados em | Cadeia de caracteres |
| Retornar | Retorna o valor verdadeiro ou falso. Se o valor for verdadeiro, o arquivo foi aberto ou criado com sucesso. | Saída de dados | Booliano |
AdicionarNovaPlanilha
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da nova planilha que o método adiciona ao arquivo. | Dados em | Cadeia de caracteres |
Preenchimento automático
Preenche automaticamente as células em um intervalo especificado com base no conteúdo de células adjacentes ou em um padrão predefinido. Este método é útil para copiar dados ou formatar em várias células. Microsoft Excel analisa o conteúdo da seleção inicial e a extrapola para preencher o intervalo desejado. Ele pode ser usado para estender uma série de números, duplicar fórmulas, replicar padrões de texto ou executar qualquer outro processamento de entrada de dados.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que contém os dados de origem. | Dados em | Cadeia de caracteres |
| SourceRange | Intervalo de células com os dados ou fórmulas a serem replicados. | Dados em | Cadeia de caracteres |
GetSheetNames
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Retornar | Retorna os nomes das planilhas no documento Microsoft Excel aberto. | Saída de dados | Cadeia de caracteres |
Encerrar
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| salvarMudanças | Se o valor estiver definido como Verdadeiro, as mudanças no arquivo serão salvas antes de fechar. Se definido como falso, nenhuma mudança será salva. | Dados em | Booliano |
ColumnsCount
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que o método usa para contar o número de colunas. | Dados em | Cadeia de caracteres |
| Retornar | Retorna a contagem de colunas na planilha. | Saída de dados | Números inteiros |
Copiar
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Nome da planilha | Nome da planilha que contém os dados de origem. | Dados em | Cadeia de caracteres |
| Intervalo de células | Intervalo de células a serem copiadas. | Dados em | Cadeia de caracteres |
Cole
cola o conteúdo da área de transferência em células específicas fornecidas no parâmetro cellLocation de uma planilha. Também pode ser um intervalo de células.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Nome da planilha | Nome da planilha em que o conteúdo da área de transferência será colado. | Dados em | Cadeia de caracteres |
| LocalizaçãoCelular | Indica o local (referência de célula) onde o conteúdo da área de transferência será colado. | Dados em | Cadeia de caracteres |
PreencherValoresBranco
Preenche células vazias em uma coluna especificada de uma planilha em um arquivo Microsoft Excel com um determinado valor. Ele requer o parâmetro SheetName para especificar a planilha, o parâmetro ColumnName para identificar a coluna e o parâmetro Value para fornecer o valor de substituição para as células vazias.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Nome da planilha | Nome da folha para preencher valores em branco. | Dados em | Cadeia de caracteres |
| Nome da coluna | Nome da coluna na planilha que precisa ser preenchida com um valor. ColumnName é um tipo de dados Enum que representa colunas do Excel de A a AZ. |
Dados em | Nome da coluna |
| Valor | Valor a ser preenchido na coluna. | Dados em | Cadeia de caracteres |
CriarGráfico
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da folha em que o gráfico é criado. | Entrada de dados | Cadeia de caracteres |
| Intervalo de células | Intervalo de células a partir do qual o gráfico é criado. | Entrada de dados | Cadeia de caracteres |
| Tipo de gráfico | Especifica o tipo de gráfico a ser criado. Os tipos de gráficos disponíveis dependem da implementação específica do conector do Excel que está sendo usado. |
Entrada de dados | ExcelChartType |
| Retornar | Se verdadeiro, o gráfico foi criado com sucesso. Se falso, a criação do gráfico falhou. | Saída de dados | Booliano |
CriarTabela Dinâmica
Gera uma tabela dinâmica na planilha especificada, utilizando as configurações definidas na janela "Configurações da tabela dinâmica".
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha em que a tabela dinâmica deve ser criada. | Entrada de dados | Cadeia de caracteres |
| Nome da tabela dinâmica | Nome da tabela dinâmica. | Entrada de dados | Cadeia de caracteres |
ExcluirColuna
Exclui uma coluna em uma determinada folha com base no índice especificado da coluna.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha da qual a coluna é excluída. | Entrada de dados | Cadeia de caracteres |
| ColumnIndex | Índice da coluna que deve ser excluída. No Excel, as colunas são rotuladas em ordem alfabética (A, B, C etc.) e cada coluna tem um índice numérico correspondente (1 para a coluna A, 2 para a coluna B e assim por diante). |
Entrada de dados | Números inteiros |
| Retornar | Retorna o valor booliano que indica se a coluna foi excluída. Se for verdadeiro, a coluna será excluída. Se falso, a coluna não foi excluída. | Saída de dados | Booliano |
ExcluirConteúdoDoIntervalo
Exclui o conteúdo do intervalo de células especificado.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha da qual o conteúdo será excluído. | Entrada de dados | Cadeia de caracteres |
| Intervalo de células | Especifica o intervalo de células do qual os dados são excluídos. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna o valor booliano que indica se o conteúdo do intervalo de células foi excluído. Se verdadeiro, o conteúdo será excluído. Se for falso, o conteúdo não será excluído. | Saída de dados | Booliano |
ExcluirColunasVazias
Exclui colunas que não têm conteúdo em uma planilha especificada de um arquivo Microsoft Excel. Este método requer o parâmetro SheetName para identificar a planilha.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que contém a coluna vazia. | Entrada de dados | Cadeia de caracteres |
DeleteEmptyRows
Exclui linhas que não têm conteúdo em uma planilha especificada de um arquivo Microsoft Excel. Este método requer o parâmetro SheetName para identificar a planilha.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que contém as linhas vazias. | Entrada de dados | Cadeia de caracteres |
Excluir linha
Exclui uma linha da planilha com base no parâmetro RowNumber.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha da qual a linha é excluída. | Entrada de dados | Cadeia de caracteres |
| NúmeroDeLinha | Indica o número da linha que deve ser excluída. | Entrada de dados | Números inteiros |
| Retornar | Retorna o valor booliano que indica se a linha foi excluída. Se verdadeiro, a linha será excluída. Se for falso, a linha não será excluída. | Saída de dados | Booliano |
Excluir planilha
Exclui a planilha especificada. Este método requer o parâmetro SheetName para identificar a planilha.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que deve ser excluída. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna o valor booliano que indica se a planilha foi excluída. Se for verdadeiro, a planilha será excluída. Se for falso, a planilha não será excluída. | Saída de dados | Booliano |
ExportChartAsImages
Exporta e salva um gráfico presente em uma folha em um arquivo de imagem que é salvo no caminho especificado. Esse processo separa o gráfico da pasta de trabalho do Excel, fornecendo uma representação visual autônoma que pode ser facilmente compartilhada ou inserida em vários documentos, apresentações ou relatórios.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da folha que contém o gráfico. | Entrada de dados | Cadeia de caracteres |
| Salvar caminho da pasta | Especifica o caminho da pasta em que os gráficos são salvos como arquivos de imagem. | Entrada de dados | Cadeia de caracteres |
Exportar para PDF
Exporta um arquivo do Excel como um arquivo PDF para o local do caminho mencionado no parâmetro FilePath.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Caminho do arquivo | Especifica o caminho do arquivo para o qual o arquivo PDF será exportado. | Entrada de dados | Cadeia de caracteres |
LocalizarESubstituir
Localiza o texto fornecido no parâmetro FindText em uma determinada planilha especificada pelo parâmetro SheetName e o substitui por outro texto fornecido no parâmetro SubstituirTo.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha em que o texto será substituído. | Entrada de dados | Cadeia de caracteres |
| LocalizarTexto | O texto pesquisado nas células da planilha. | Entrada de dados | Cadeia de caracteres |
| Substituir para | O texto desejado para substituir o texto encontrado usando o parâmetro FindText. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna o valor booliano que indica se o texto foi substituído. Se for verdadeiro, o texto será substituído. Se for falso, o texto não será substituído. | Saída de dados | Booliano |
GetActiveSheetName
Retorna o nome da planilha ativa.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Retornar | Retorna o nome da planilha ativa em um formato de cadeia de caracteres. | Saída de dados | Cadeia de caracteres |
ObterEndereçoDeCélulaSeRowHas
Pesquisa um determinado texto na folha especificada. Ele verifica o nome da coluna especificada, começando pelo índice de linha indicado. Se o texto for encontrado, ele retornará verdadeiro. Senão, retorna falso. Além disso, o endereço da célula correspondente pode ser armazenado no valor configurado.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha na qual pesquisar. | Entrada de dados | Cadeia de caracteres |
| SearchText | O texto a ser pesquisado na coluna especificada. | Entrada de dados | Cadeia de caracteres |
| PesquisarColuna | A coluna em que a pesquisa será realizada. ColumnName é um tipo de dados Enum que representa colunas do Excel de A a AZ. |
Entrada de dados | Nome da coluna |
| StartRowIndex | O índice de linha a partir do qual a pesquisa será iniciada. | Entrada de dados | Números inteiros |
| Retornar | Retorna um valor booliano que indica se o SearchText foi encontrado. Se for verdadeiro, o texto será encontrado. Se for falso, o texto não será encontrado. | Saída de dados | Booliano |
ObterFormulaCélula
Recupera a fórmula da célula de uma planilha.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha da qual a fórmula da célula será recuperada. | Entrada de dados | Cadeia de caracteres |
| NomeCélula | Especifica o nome ou a referência da célula da qual a fórmula será recuperada. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna a fórmula de célula especificada em um formato de cadeia de caracteres. | Saída de dados | Cadeia de caracteres |
ObterValorCélula
Recupera o valor de uma célula de uma planilha especificada pelo parâmetro Nome da célula.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha da qual o valor da célula será recuperado. | Entrada de dados | Cadeia de caracteres |
| NomeCélula | Retorna o valor da célula ou o texto de exibição com base na configuração definida em GetCellValue. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna o valor em uma célula especificada no formato de cadeia de caracteres. | Saída de dados | Cadeia de caracteres |
ObterValorDeCélulaSeRowHas
Pesquisa um determinado texto na folha especificada. Ele verifica a coluna especificada, começando pelo índice de linha indicado. Se o texto for encontrado, ele retornará verdadeiro. Senão, retorna falso. Além disso, o valor da célula correspondente pode ser armazenado no valor configurado.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha na qual pesquisar. | Entrada de dados | Cadeia de caracteres |
| SearchText | O texto a ser pesquisado na coluna especificada. | Entrada de dados | Cadeia de caracteres |
| PesquisarColuna | A coluna em que a pesquisa é realizada. ColumnName é um tipo de dados Enum que representa colunas do Excel de A a AZ. |
Entrada de dados | Nome da coluna |
| StartRowIndex | O índice de linha a partir do qual a pesquisa começa. | Entrada de dados | Números inteiros |
| Retornar | Retorna um valor booliano que indica se o SearchText foi encontrado. Se for verdadeiro, o texto será encontrado. Se for falso, o texto não será encontrado. | Saída de dados | Booliano |
ObterValoresCélulas
Retorna os valores de células de uma planilha.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que contém os dados de origem. | Entrada de dados | Cadeia de caracteres |
ObterCor
Retorna o valor RGB de uma célula especificada no parâmetro cellName de uma planilha.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha da qual a cor da célula será recuperada. | Entrada de dados | Cadeia de caracteres |
| NomeCélula | Nome ou referência da célula da qual a cor será recuperada. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna a cor da célula especificada no formato de cadeia de caracteres. | Saída de dados | Cadeia de caracteres |
GetColumnNameByIndex
Retorna o nome da coluna correspondente ao número de coluna fornecido, em que, por exemplo, 1 corresponde a "A".
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| ColumnNumber | O número da coluna cujo nome você deseja recuperar. | Entrada de dados | Números inteiros |
| Retornar | Retorna o nome da coluna no formato de cadeia de caracteres. | Saída de dados | Cadeia de caracteres |
ObterDadosFiltro
Retorna dados filtrados de uma planilha com base nos critérios de filtro especificados. Os dados são obtidos a partir do número de linha fornecido no parâmetro RowNumber.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que contém os dados de origem. | Entrada de dados | Cadeia de caracteres |
| NúmeroDeLinha | O número da linha que é a linha inicial para a extração de dados. | Entrada de dados | Números inteiros |
| FirstRowAsHeader | Determina se a primeira linha dos dados filtrados deve ser tratada como linha de cabeçalho. Se definido como verdadeiro, a primeira linha será considerada como linha de cabeçalho e não incluída nas linhas de dados extraídos. Se definido como falso, a primeira linha será incluída como parte das linhas de dados extraídos. | Entrada de dados | Booliano |
| Retornar | Retorna os dados filtrados em um formato de tabela. As operações podem ser realizadas nas linhas e colunas desta tabela. | Saída de dados | Tabela de dados |
GetFilteredDataAddress
Retorna o endereço dos dados filtrados na planilha fornecida no parâmetro SheetName.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha da qual o endereço dos dados filtrados será recuperado. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna uma lista ou coleção de cadeias de caracteres em que as cadeias de caracteres são endereços de dados filtrados. | Saída de dados | Lista (de cadeia de caracteres) |
ObterValoresDeRinha
Retorna valores de célula do parâmetro SheetName especificado para extrair os valores. Por padrão, se RowNumber não for especificado (ou definido como -1), ele lerá os valores da última linha. Além disso, você pode incluir parâmetros de saída para adicionar nomes de coluna e armazenar seus valores na saída.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Especifica o nome da planilha da qual os valores serão recuperados. | Entrada de dados | Cadeia de caracteres |
| NúmeroDeLinha | A linha da qual os valores serão lidos. Se definido como -1, o padrão será a última linha. | Entrada de dados | Números inteiros |
GetSelectedRange
Retorna o intervalo de células selecionado no momento na planilha especificada no parâmetro SheetName. Os dados são extraídos das áreas específicas da planilha que foram realçadas ou escolhidas.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que contém os dados de origem. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna o intervalo de células selecionado em uma planilha no formato de cadeia de caracteres. | Saída de dados | Cadeia de caracteres |
GetSheetNames
Retorna uma lista de todos os nomes de planilha presentes em um arquivo do Excel.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Retornar | Retorna todos os nomes de planilha disponíveis em um formato de matriz de cadeia de caracteres. | Saída de dados | Cadeia de caracteres[] |
GetUsedRange
Retorna o intervalo de células usadas da planilha especificada.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha da qual o intervalo será lido. | Entrada de dados | Cadeia de caracteres |
| IncludeHeaders | Indica se os cabeçalhos devem ser incluídos. | Entrada de dados | Booliano |
| Retornar | Retorna o intervalo de células usadas no formato de cadeia de caracteres. | Saída de dados | Cadeia de caracteres |
ObterValoresPorColuna
Retorna uma lista de valores de um ColumnName especificado no SheetName fornecido com base nos critérios de parâmetros Distinct, FirstRowAsHeader e ValueType.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que contém os dados de origem. | Entrada de dados | Cadeia de caracteres |
| Nome da coluna | Denota o nome da coluna da qual os valores são recuperados. ColumnName é um tipo de dados Enum que representa colunas do Excel de A a AZ. |
Entrada de dados | Nome da coluna |
| FirstRowAsHeader | Indica se a primeira linha na coluna especificada contém cabeçalhos. | Entrada de dados | Booliano |
| Distinto | Especifica se os valores recuperados devem ser distintos ou exclusivos. | Entrada de dados | Booliano |
| ValueType | Extrai valores com base na visibilidade. | Entrada de dados | ValorT |
| Retornar | Retorna o número de linhas. | Saída de dados | Números inteiros |
InserirNovaColuna
Insere uma nova coluna no índice fornecido no parâmetro ColumnNumber na planilha especificada.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha em que a coluna deve ser inserida. | Entrada de dados | Cadeia de caracteres |
| ColumnIndex | Especifica o índice da coluna em que a nova coluna está inserida. Por exemplo, 1 é A, 2 é B e assim por diante. | Entrada de dados | Números inteiros |
InserirNovaLinha
Insere uma nova linha no índice especificado na planilha especificada.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha em que a linha será inserida. | Entrada de dados | Cadeia de caracteres |
| ÍndiceDeLinha | Índice da linha. A linha será inserida no índice especificado. | Entrada de dados | Números inteiros |
| Retornar | Retorna o valor booliano que indica se uma linha foi inserida. Se for verdadeiro, a linha será inserida. Se for falso, a linha não será inserida. | Saída de dados | Booliano |
Inserir objeto
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha em que o método insere o objeto. | Entrada de dados | Cadeia de caracteres |
| NomeCélula | Nome da célula em que o método insere o objeto. Por exemplo, A1. | Entrada de dados | Cadeia de caracteres |
| Caminho do arquivo | Caminho do arquivo do objeto que o método insere. | Entrada de dados | Cadeia de caracteres |
Está aberto
Verifica se uma pasta de trabalho Microsoft Excel ou arquivo no local fornecido no parâmetro Filepath está aberto ou não.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Caminho do arquivo | Caminho para o arquivo do Excel na unidade local. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna o valor booliano que indica se o arquivo do Excel está aberto. Se for verdadeiro, o arquivo do Excel será aberto. Se for falso, o arquivo do Excel não será aberto. | Saída de dados | Booliano |
MesclarCélulas
Mescla as células especificadas no intervalo na planilha especificada.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Nome da planilha | Nome da planilha na qual as células serão mescladas. | Entrada de dados | Cadeia de caracteres |
| Intervalo de células | Intervalo de células. Todas as células dentro do intervalo são mescladas. | Entrada de dados | Cadeia de caracteres |
ReadFromRange
Recupera dados de uma planilha especificada e os retorna. Você precisa fornecer o nome da planilha para indicar de qual planilha extrair o intervalo de células, especificar o intervalo de células para determinar o intervalo de células a ser lido e indicar se a primeira linha é um cabeçalho no parâmetro FirstRowAsHeader.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha de onde o método lê os dados. | Entrada de dados | Cadeia de caracteres |
| Intervalo de células | Intervalo de células. O método lê dados dessas células. | Entrada de dados | Cadeia de caracteres |
| FirstRowAsHeader | Valor booliano que indica se o método trata a primeira linha como o cabeçalho. Se for verdadeiro, a primeira linha será tratada como um cabeçalho. Se falso, a primeira linha não será tratada como um cabeçalho. | Entrada de dados | Booliano |
| Retornar | Retorna a tabela de dados que compreende os dados das células. | Saída de dados | Tabela de dados |
Ler da planilha
Extrai dados de uma planilha e os converte em um formato estruturado, como uma DataTable.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Nome da planilha | Nome da planilha da qual o método lê os dados. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna todos os dados na planilha especificada. | Saída de dados | Tabela de dados |
RenomearSheetName
Renomeia uma planilha existente.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| AntigoNomeDePlanilha | O nome existente da planilha. | Entrada de dados | Cadeia de caracteres |
| NewSheetName | O novo nome da planilha. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna a resposta booliana que indica se a planilha foi renomeada. Se for verdadeiro, a planilha será renomeada. Se for falso, a planilha não será renomeada. | Saída de dados | Booliano |
Contagem de linhas
Retorna a contagem de linhas na planilha especificada.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha de onde a contagem de linhas é retornada. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna o número de linhas. | Saída de dados | Números inteiros |
Executar Macro
Executa uma macro existente no arquivo do Excel. O método requer o nome da macro que o usuário pretende executar.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| MacroName | O nome da Macro a ser executada. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna o valor booliano que indica se a macro foi executada com sucesso ou não. | Saída de dados | Booliano |
Redimensionar
Altera as dimensões de largura e altura da janela da aplicação Excel. O layout e a aparência da aplicação Excel podem ser personalizados para acomodar requisitos de exibição específicos.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Esquerda | Este parâmetro especifica a posição horizontal do canto superior esquerdo da janela do aplicativo Excel em relação à borda esquerda da tela. Ele define a distância, em pixels ou pontos, da borda esquerda da tela até a borda esquerda da janela do Excel. | Entrada de dados | Números inteiros |
| Superior | Este parâmetro indica a posição vertical do canto superior esquerdo da janela do aplicativo Excel em relação à borda superior da tela. Ele define a distância, em pixels ou pontos, da borda superior da tela até a borda superior da janela do Excel. | Entrada de dados | Números inteiros |
| Largura | Este parâmetro especifica a largura da janela do aplicativo Excel em pixels ou pontos. Ele determina o tamanho horizontal da janela, que se estende da borda esquerda à borda direita. | Entrada de dados | Números inteiros |
| Altura | Este parâmetro indica a altura da janela do aplicativo Excel em pixels ou pontos. Ele define o tamanho vertical da janela, que se estende da borda superior à borda inferior. | Entrada de dados | Números inteiros |
RemoverFiltro
Remove filtros de uma planilha fornecida no parâmetro SheetName.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Nome da planilha | Nome da planilha da qual o método remove os filtros. | Entrada de dados | Cadeia de caracteres |
Salvar
Salva todas as atualizações, mudanças, adições ou exclusões feitas nos dados ou formatação em um documento Microsoft Excel para garantir que o trabalho seja preservado e que o arquivo do Excel reflita as atualizações mais recentes.
Salvar como
Salva um arquivo do Excel com um nome ou formato diferente em um caminho de arquivo fornecido no parâmetro Filepath. O arquivo também pode ser protegido por senha, fornecendo o valor no parâmetro Senha.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Caminho do arquivo | O caminho do arquivo em que o arquivo do Excel é salvo com um nome ou formato diferente. | Entrada de dados | Cadeia de caracteres |
| Senha | Senha para proteger o arquivo do Excel que será salvo. Este parâmetro é opcional e tem um valor padrão de uma cadeia de caracteres vazia. | Entrada de dados | Cadeia de caracteres |
SalvarCópiaComo
Salva uma cópia do arquivo do Excel em um caminho especificado que serve como destino para a cópia salva.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Caminho do arquivo | O caminho do arquivo em que o arquivo do Excel é salvo com um nome ou formato diferente. | Entrada de dados | Cadeia de caracteres |
| Senha | Senha para proteger o arquivo do Excel que é salvo. Este parâmetro é opcional e tem um valor padrão de uma cadeia de caracteres vazia. | Entrada de dados | Cadeia de caracteres |
SelecionarIntervalo
Especifica e realça um intervalo de células em uma planilha do Excel.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que contém os dados de origem. | Entrada de dados | Cadeia de caracteres |
| Intervalo de células | O intervalo de células selecionadas na planilha especificada. Ele define o grupo de células, normalmente identificado pelas referências de célula inicial e final, que será realçado ou ativado. | Entrada de dados | Cadeia de caracteres |
SelectRowByIndex
Seleciona a linha inteira com base no índice fornecido no parâmetro RowNumber na planilha.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha em que a linha está selecionada. | Entrada de dados | Cadeia de caracteres |
| NúmeroDeLinha | O índice da linha a ser selecionada. | Entrada de dados | Números inteiros |
Definir planilha ativa
Marca a planilha especificada em Sheetname como a planilha ativa.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que precisa ser definida como ativa. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna o valor booliano que indica se a planilha fornecida foi definida como ativa ou não. | Saída de dados | Booliano |
Definir alinhamento
Ajusta as configurações de alinhamento das células fornecidas no cellRange para controlar a apresentação e a aparência dos dados na planilha do Excel e aprimorar o recurso visual e a legibilidade dos dados da planilha, melhorando a apresentação de dados e a comunicação.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que contém os dados de origem. | Entrada de dados | Cadeia de caracteres |
| Intervalo de células | Intervalo de células ao qual as configurações ou propriedades de alinhamento são aplicadas. | Entrada de dados | Cadeia de caracteres |
| Alinhamento horizontal | Alinhamento horizontal do conteúdo da célula dentro do intervalo especificado. Ele determina como o conteúdo (por exemplo, texto ou números) é posicionado em cada célula horizontalmente. Os valores possíveis incluem esquerda, central, direita, justificado ou distribuído. | Entrada de dados | Alinhamento horizontal |
| VerticalAlignment | Alinhamento vertical do conteúdo da célula dentro do intervalo especificado. Ele determina como o conteúdo é posicionado verticalmente em cada célula. Os valores possíveis incluem superior, médio, inferior ou justificado. | Entrada de dados | VerticalAlignment |
DefinirCorDeCélula
Define uma cor fornecida no parâmetro Color em uma célula específica especificada no parâmetro cellName em uma planilha.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha em que a célula está localizada. | Entrada de dados | Cadeia de caracteres |
| NomeCélula | Indica o nome ou a referência da célula para a qual a cor será definida. | Entrada de dados | Cadeia de caracteres |
| Cor | Especifica o valor de cor RGB a ser aplicado à célula. | Entrada de dados | ExcelRgbColor |
| Retornar | Retorna o valor booliano que indica se a fórmula está definida para uma célula específica fornecida. | Saída de dados | Booliano |
DefinirCélulaFormula
Atribui uma fórmula a uma célula especificada no arquivo do Excel. Este método requer os parâmetros SheetName, CelularNome Fórmula para determinar a planilha, a célula e a fórmula a serem definidas, respectivamente.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha em que a ação será executada. | Entrada de dados | Cadeia de caracteres |
| NomeCélula | A célula na planilha em que a operação ocorrerá. | Entrada de dados | Cadeia de caracteres |
| Fórmula | A expressão matemática ou lógica a ser aplicada à célula especificada. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna o valor booliano que indica se a fórmula está definida para a célula especificada. | Saída de dados | Booliano |
DefinirValorCélula
Atribui um valor a uma célula específica em uma planilha, substituindo qualquer conteúdo existente nessa célula.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que contém os dados de origem. | Entrada de dados | Cadeia de caracteres |
| NomeCélula | Este parâmetro indica a referência ou o identificador da célula de destino na planilha especificada. Pode ser representado pelo endereço da célula (por exemplo, 'A1', 'B2', 'C3'). | Entrada de dados | Cadeia de caracteres |
| Valor | Valor que será atribuído à célula especificada, que pode ser de qualquer tipo de dados compatível com o Excel, incluindo números, texto, datas, fórmulas ou valores lógicos. | Entrada de dados | Cadeia de caracteres |
DefinirValoresDeCélula
Define valores em várias células conforme configurado na caixa de diálogo do editor de método em uma planilha especificada.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha em que os valores das células serão definidos. | Entrada de dados | Cadeia de caracteres |
DefinirValoresDeCélulaSeRowHas
Verifica a folha especificada em busca de um texto fornecido, examinando o nome da coluna designada do índice de linha indicado. Se o texto for encontrado, ele definirá o valor da célula especificada com os valores fornecidos. Ele retorna verdadeiro se o valor foi definido com sucesso, caso contrário, retorna falso.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha na qual pesquisar. | Entrada de dados | Cadeia de caracteres |
| SearchText | O texto a ser pesquisado na coluna especificada. | Entrada de dados | Cadeia de caracteres |
| PesquisarColuna | A coluna em que a pesquisa é realizada. ColumnName é um tipo de dados Enum que representa colunas do Excel de A a AZ. |
Entrada de dados | Nome da coluna |
| StartRowIndex | O índice de linha a partir do qual a pesquisa começa. | Entrada de dados | Números inteiros |
| Retornar | Retorna verdadeiro se SearchText for encontrado na coluna especificada. Senão, ele retorna Falso. | Saída de dados | Booliano |
DefinirTipoDeColuna
Modifique o tipo de dados de uma coluna especificada em uma planilha. Por exemplo, os usuários podem converter uma coluna que contém valores numéricos em um formato de texto ou alterar uma coluna de dados de texto para um formato numérico. É possível ajustar o formato dos dados para melhor atender às necessidades de análise ou emissão de relatórios, garantindo consistência e precisão na representação de dados. Útil para tarefas como conversão, formatação e manipulação de dados no Excel.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que contém os dados de origem. | Entrada de dados | Cadeia de caracteres |
| Tipo de formato | O tipo de formato desejado para o qual a coluna é convertida. Este parâmetro determina como os dados na coluna são interpretados ou exibidos. Os valores possíveis podem incluir formatos numéricos, de texto, data, hora, moeda, porcentagem ou personalizados. | Entrada de dados | Cadeia de caracteres |
| Coluna | A referência ou identificador de coluna na planilha especificada para a qual o tipo de dados é alterado. Pode ser representado pela letra da coluna (por exemplo, 'A', 'B', 'C'). | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna o valor booliano que identifica se o tipo de coluna foi definido ou não. | Saída de dados | Booliano |
Definir largura da coluna
Define a largura de todas as colunas fornecidas no parâmetro de largura.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha em que a largura da coluna é ajustada. | Entrada de dados | Cadeia de caracteres |
| Largura | A largura em caracteres para a qual a coluna está definida. | Entrada de dados | Números inteiros |
| Retornar | Retorna o valor booliano que identifica se o tipo de coluna foi definido ou não. | Saída de dados | Booliano |
Definir filtro
Aplica um filtro a uma coluna específica. Este método encontra a planilha com base no nome da planilha fornecido e aplica o valor de filtro fornecido.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha em que a coluna está localizada. | Entrada de dados | Cadeia de caracteres |
| Nome da coluna | Coluna em que o filtro é aplicado. ColumnName é um tipo de dados Enum que representa colunas do Excel de A a AZ. |
Entrada de dados | Nome da coluna |
| FilterValue | O valor a ser filtrado na coluna identificada. | Entrada de dados | Cadeia de caracteres |
DefinirFiltroPorLinha
Aplica um filtro a uma coluna especificada, a partir de um determinado número de linha. Este método encontra a planilha com base no nome da planilha fornecido e aplica o valor de filtro fornecido.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que contém os dados de origem. | Entrada de dados | Cadeia de caracteres |
| NúmeroDeLinha | Indica o número da linha na planilha especificada em que os critérios de filtragem são definidos. Ele identifica a linha que contém os critérios que serão usados para filtrar os dados. | Entrada de dados | Números inteiros |
| Nome da coluna | Nome ou identificador da coluna com base na qual a filtragem será realizada. Representa a coluna à qual os critérios de filtragem se aplicam. ColumnName é um tipo de dados Enum que representa colunas do Excel de A a AZ. O ColumnName fornecido se refere ao nome da coluna em relação à coluna inicial dos seus dados. Por exemplo, se os dados começarem na coluna B na planilha do Excel, o índice de coluna relativo A corresponderá à coluna B, o índice de coluna relativo B corresponderá à coluna C e assim por diante. |
Entrada de dados | Nome da coluna |
| FilterValue | Valor ou condição usada como critério de filtro. Representa o valor específico ao qual os dados na coluna designada devem corresponder para serem exibidos depois que o filtro é aplicado. | Entrada de dados | Cadeia de caracteres |
DefinirEstiloFonte
Formata as células dentro de um intervalo especificado definindo parâmetros como Cor, FontStyle, FontName, Negrito e Sublinhado.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha em que o estilo da fonte será definido. | Entrada de dados | Cadeia de caracteres |
| Intervalo de células | O intervalo de células para o qual o estilo da fonte será definido. | Entrada de dados | Cadeia de caracteres |
| Cor | Especifica o valor da cor RGB da fonte. | Entrada de dados | ExcelRgbColor |
| Tamanho da fonte | Especifica o tamanho da fonte. O valor padrão é 11. | Entrada de dados | Números inteiros |
| NomeDaFonte | Especifica o nome da fonte. O valor padrão é Calibri. | Entrada de dados | Cadeia de caracteres |
| Negrito | Indica se a fonte deve estar em negrito. O valor padrão é falso. | Entrada de dados | Booliano |
| Sublinhado | Especifica o estilo de sublinhado da fonte. O valor padrão é Nenhum. | Entrada de dados | Sublinhado |
Definir altura da linha
Modifica a altura de uma linha específica em uma planilha do Excel.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | O nome da planilha em que as linhas estão localizadas. | Entrada de dados | Cadeia de caracteres |
| Altura | Especifica a altura desejada. | Entrada de dados | Números inteiros |
| StartIndex | O índice de linha inicial. | Entrada de dados | Cadeia de caracteres |
| EndIndex | O índice da linha final. | Entrada de dados | Cadeia de caracteres |
| Retornar | Retorna um valor booliano que indica se a altura da linha foi definida com sucesso ou não. | Saída de dados | Booliano |
DefinirValoresDeRow
Define valores para uma linha específica em uma planilha do Excel. Por padrão, quando o parâmetro RowIndex é definido como -1, a função insere os valores no final da planilha. Isso significa que, se você não especificar um índice de linha específico, os valores serão anexados à parte inferior dos dados existentes na planilha.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que contém os dados de origem. | Entrada de dados | Cadeia de caracteres |
| NúmeroDaLinha | Denota o número da linha em que os valores serão definidos ou atualizados. No Excel, as linhas são numeradas sequencialmente de cima para baixo, começando com 1 especificando o RowNumber. Você indica a linha específica onde os valores devem ser colocados. Se -1 for passado como o RowNumber, isso normalmente indica que os valores serão inseridos no final da planilha. | Entrada de dados | Números inteiros |
Classificação
Organiza os dados dentro de um intervalo de células especificado em ordem crescente ou decrescente.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha em que os dados serão classificados. | Entrada de dados | Cadeia de caracteres |
| Intervalo de células | O intervalo de células que contém os dados a serem classificados. | Entrada de dados | Cadeia de caracteres |
| Nome da coluna | O nome da coluna pela qual os dados serão classificados. ColumnName é um tipo de dados Enum que representa colunas do Excel de A a AZ. |
Entrada de dados | Nome da coluna |
| OrdemDeClassificação | A ordem de classificação (crescente ou decrescente) dos dados. | Entrada de dados | OrdemDeClassificação |
VPesquisar
Pesquisa um valor específico na primeira coluna de um intervalo de células especificado e retorna um valor correspondente de uma coluna designada na mesma linha.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| Nome da planilha | Nome da planilha na qual pesquisar. | Entrada de dados | Cadeia de caracteres |
| SearchText | O texto a ser pesquisado na coluna especificada. | Entrada de dados | Cadeia de caracteres |
| Intervalo de pesquisa | Intervalo para verificar o texto. | Entrada de dados | Cadeia de caracteres |
| ApproximateMatch | Este é um valor lógico que especifica se você deseja uma correspondência exata ou aproximada. | Entrada de dados | Booliano |
| Retornar | Retorna o valor booliano que indica se a macro foi executada com sucesso ou não. | Saída de dados | Booliano |
Encapsular texto
Habilite a quebra de texto para todas as células em uma linha especificada em uma planilha do Excel. A quebra de texto garante que cadeias de caracteres de texto longas sejam exibidas dentro dos limites da célula, ajustando automaticamente a altura da linha para acomodar o texto quebrado. Usando o método WrapText, os usuários podem melhorar a legibilidade de seus dados, garantindo que todo o texto esteja totalmente visível em cada célula, mesmo que ele se estenda além da largura original da célula. Isso pode ser particularmente útil para exibir entradas de texto longas ou conteúdo de várias linhas em células de planilha.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha que contém os dados de origem. | Entrada de dados | Cadeia de caracteres |
| NúmeroDaLinha | O número da linha na planilha especificada em que a quebra de texto está definida para todas as células nessa linha. | Entrada de dados | Números inteiros |
GravarNoIntervalo
Grava uma tabela de dados fornecida no parâmetro Data em uma planilha a partir da célula fornecida no parâmetro cellName. Os cabeçalhos também podem ser incluídos definindo o parâmetro IncludeHeaders.
| Parâmetro | Descrição | Tipo de porta de dados | Tipo de dados |
|---|---|---|---|
| SheetName | Nome da planilha na qual os dados são gravados. | Entrada de dados | Cadeia de caracteres |
| NomeCélula | Nome da célula na qual os dados são gravados. | Entrada de dados | Cadeia de caracteres |
| Dados | Dados gravados. | Entrada de dados | Tabela de dados |
| IncludeHeaders | Valor booliano que indica se os cabeçalhos devem ser incluídos ao gravar os dados. O valor padrão é definido como Verdadeiro. | Entrada de dados | Booliano |