Ejemplo de uso del paquete DLL

Construya una DLL muy sencilla que generará un mensaje. Cree un bot para ejecutar la DLL.

Este tema muestra cómo crear un paquete DLL. Si no tiene Microsoft Visual Studio, descargue la versión comunitaria gratuita desde Microsoft Visual Studio Community IDE.

Procedimiento

Cree el paquete DLL.

  1. En Microsoft Visual Studio, cree una nueva biblioteca de clases que generará un archivo de tipo .dll utilizando C#.
    1. Navegue hasta Archivo > Nuevo > Proyecto.
    2. Busque dll en el campo Buscar plantillas.
    3. Seleccione la opción de biblioteca C#.
    4. Configure su proyecto de la siguiente manera:
      • Nombre del proyecto: DemoDLL
      • Location: [Cualquiera]
      • Nombre de la solución: DemoDLL
    5. Haga clic en Crear.
    6. Copie el siguiente código y reemplace el contenido de class1.cs pegando:
      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. En Explorador de soluciones, haga clic con el botón derecho en Class1.cs y cámbiele el nombre a "CallMe.cs".
    8. Navegue hasta Archivo > Guardar todo.
    9. Navegue hasta Crear > Crear solución.
      La ventana de salida confirma que el paquete DLL se ha creado correctamente y muestra la ruta de su nuevo paquete DemoDLL.dll en la ventana Salida. Anote la ubicación del paquete, ya que la necesitará más tarde para ingresar en el bot.

Cree un bot para ejecutar el paquete DLL.

  1. Cree un bot.
    1. En el panel izquierdo, haga clic en Automatización.
      Se muestra la lista de bots y formularios disponibles.
    2. Haga clic en Crear nuevo > Bot.
    3. Proporcione un nombre para el bot: MyDLLbot
    4. Ingrese la ubicación de la carpeta: Bots\TaskBotExample
    5. Haga clic en Crear y editar.
  2. Cree una variable: sReturnedString: tipo cadena
  3. Utilice la acción DLL > Abrir para cargar su paquete DLL.
    1. En el panel Acciones, haga doble clic en la acción DLL > Abrir o arrástrela.
    2. En el campo DLL:Abrir, Ruta de archivo, seleccione el tipo de archivo Archivo de escritorio y haga clic en Explorar… para buscar su paquete DLL. Haga clic en Abrir.
    3. Haga clic en Guardar.
  4. Utilice la acción DLL > Ejecutar función para ejecutar su paquete DLL.
    1. Haga doble clic en la acción DLL > Ejecutar función o arrástrela a la última línea del bot.
    2. Haga clic en Obtener detalles de la DLL.
    3. Seleccione el tipo Archivo de escritorio y, luego, haga clic en Explorar…. Localice su paquete DLL y haga clic en Abrir.
    4. Haga clic en Siguiente.
    5. Expanda el espacio de nombres de DemoDLL y seleccione la función CallMe. Seleccione el método ImHere y haga clic en Aplicar.
    6. En el campo Asignar el valor a una variable, seleccione sReturnedString.
  5. Utilice la acción Cuadro de mensaje para informar lo que devolvió el bot de la DLL:
    1. Haga doble clic en la acción Cuadro de mensaje o arrástrela a la última línea del bot.
    2. En el campo Escriba el mensaje para mostrar, escriba: From the DLL: "$sReturnedString$".
  6. Haga clic en Guardar.
  7. Utilice la acción DLL > Cerrar para terminar la sesión de la DLL.
    1. Haga doble clic en la acción DLL > Cerrar o arrástrela a la última línea del bot.
  8. Haga clic en Guardar.
  9. Haga clic en la pestaña Lista para ver su código en modo de solo texto.
    Su código debería verse así:
    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. Ejecute su bot.
    El paquete DLL devuelve un mensaje al bot: De la DLL: "¡Ahora está dentro de la función DemoDLL, ImHere!".