Exemplo de utilização do pacote DLL

Construa uma DLL muito simples que gerará uma mensagem. Crie um bot para executar a DLL.

Este tópico mostra como criar um pacote DLL. Se você não tiver o Microsoft Visual Studio, baixe a versão gratuita da Comunidade em Microsoft Visual Studio Community IDE.

Procedimento

Criar o pacote DLL.

  1. Em Microsoft Visual Studio, crie uma nova biblioteca de classe que irá gerar um arquivo do tipo .dll usando C#.
    1. Navegue para Arquivo > Novo > Projeto.
    2. Busque por dll no campo Busca de modelos.
    3. Selecione a opção de biblioteca C#.
    4. Configure seu projeto da seguinte forma:
      • Nome do projeto: DemoDLL
      • Local: [Qualquer]
      • Nome da solução: DemoDLL
    5. Clique em Create (Criar).
    6. Copie e cole o seguinte código e substitua o conteúdo da classe1.cs: 
      using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace DemoDLL
{
    public class CallMe
    {
        public string ImHere()
        {
            String Reply = "You are now inside the DemoDLL, ImHere function!";
            return Reply;
        }
    }
}
    7. Em Explorador de soluções, clique com o botão direito do mouse em Classe1.cs e renomeie para “CallMe.cs”.
    8. Navegue para Arquivo > Salvar tudo.
    9. Navegue para Construir > Construir solução.
      A janela de saída confirma que o pacote DLL foi criado com sucesso e exibe o caminho para seu novo pacote DemoDLL.dll na janela Saída. Observe a localização do pacote, pois você precisará dele mais tarde para entrar no bot.

Criar um bot para executar o pacote DLL.

  1. Crie um bot.
    1. No painel do lado esquerdo, clique em Automação.
      Será exibida uma lista de formulários e bots disponíveis.
    2. Clique em Criar novo > Bot.
    3. Insira um nome para o bot: MyDLLbot
    4. Insira a localização da pasta: Bots\TaskBotExample
    5. Clique em Criar e editar.
  2. Criar uma variável: sReturnedString: tipo de string.
    Criar uma variável
  3. Use um DLL > Abrir ação para carregar seu pacote DLL.
    1. No painel de ações, clique duas vezes ou arraste o DLL > Abrir ação.
    2. No campo DLL:Abrir, Caminho do arquivo, selecione o tipo de arquivo Arquivo de área de trabalho e clique Procurar para encontrar seu pacote DLL. Clique em Abrir.
    3. Clique em Salvar.
  4. Use um DLL > Função Executar ação para executar seu pacote DLL.
    1. Clicar duas vezes ou arrastar o DLL > Função Executar ação até a última linha do bot.
    2. Clique Obter detalhes da DLL.
    3. Selecione Arquivo de área de trabalho digite e depois clique em Procurar. Localize seu pacote DLL e clique em Abrir.
    4. Clique em Avançar.
    5. Expanda o namespace DemoDLL e selecione a função CallMe. Selecione o método ImHere e clique em Aplicar.
    6. No campo Atribuir o valor a uma variável, selecione sReturnedString.
  5. Use uma Caixa de mensagens ação para relatar o que foi devolvido da DLL bot:
    1. Clique duas vezes ou arraste a Caixa de mensagem ação para a última linha do bot.
    2. No campo Inserir a mensagem a ser exibida, insira: From the DLL: "$sReturnedString$".
  6. Clique em Salvar.
  7. Use o ação DLL > Fechar para encerrar a sessão de DLL.
    1. Clique duas vezes ou arraste o ação DLL > Fechar até a última linha do bot.
  8. Clique em Salvar.
  9. Clique na guia Lista para visualizar seu código no modo somente texto.
    Seu código deve ser parecido com este:
    Start
DLL:Open "C:\myFolder\source\repos\DemoDLL\DemoDLL\bin\Debug\DemoDLL.dll for session "Default"
DLL:Run function "ImHere" and store output in variable $sReturnedString$ and session "Default"
MessageBox "From the DLL: "$sReturnedString$".
DLL:Close session "Default"
End
  10. Execute seu bot.
    O pacote DLL retorna uma mensagem para o bot: Da DLL: “Você está agora dentro da função DemoDLL, ImHere!”.