Saltar al contenido principal
Es posible utilizar ensamblados externos en scripts y módulos globales. Se pueden usar tanto ensamblados estándar como ensamblados de usuario compilados.

Agregar ensamblados externos

Puede agregar ensamblados externos desde la pestaña Scripts del cuadro de diálogo Propiedades del tipo de lote o en Herramientas → Opciones…. Todas las clases y los métodos de los ensamblados que agregue estarán disponibles para los scripts y los módulos globales. Los ensamblados que agregue a las propiedades de un tipo de lote o de una Definición de Document solo estarán disponibles para ese tipo de lote o esa Definición de Document. Para agregar un ensamblado:
  1. Abra el cuadro de diálogo Project Properties, haga clic en la pestaña Scripts y, a continuación, en el botón References .Net…;
  2. En el cuadro de diálogo que se abre, haga clic en Add…;
  3. En el cuadro de diálogo Add Assembly, seleccione Attached file o Standard assembly name en el campo de tipo;
  4. Según el tipo seleccionado, especifique la ruta del archivo o el nombre estándar.
A continuación puede encontrar código de ejemplo de un ensamblado de usuario que contiene un espacio de nombres, una clase y un método de esta clase:
namespace TestNameSpace
{
public class Test
    {
    public void Show(string text)
       {
      // mostrará el mensaje de texto – método estático Show(string text) de la clase System.Windows.Forms.MessageBox;
System.Windows.Forms.MessageBox.Show(text);
       }
    }
}
Un script que use una clase y métodos de un ensamblado externo debe incluir el siguiente código:
TestNameSpace.Test test = new TestNameSpace.Test(); // crea un objeto de la clase Test
test.Show(“Hello world”); // llama al método void Show() de la clase Test

Depuración de ensamblados externos

Al depurar ensamblados externos, se necesitan tanto el archivo del ensamblado como el archivo *.pdb con información simbólica. Solo se pueden depurar los ensamblados que tengan cargados archivos *.pdb. Como los archivos *.pdb son bastante grandes, recomendamos desactivar la carga de información simbólica en el proyecto de trabajo.

Claves del registro que controlan la carga de información simbólica:

Puede usar las siguientes claves del registro para especificar si se deben cargar los archivos *.pdb:
  • HKEY_CURRENT_USER\Software\ABBYY\ScanStationFC\4.0\Shell\Script [LoadSymbolsFromOriginalPath] - Especifica si los archivos *.pdb deben cargarse desde la misma carpeta desde la que se cargó el ensamblado (para cargar archivos *.pdb, establezca el valor de la clave en True)
  • HKEY_CURRENT_USER\Software\ABBYY\ScanStationFC\4.0\Shell\Script[PDBSearchLocations] = <ruta a la carpeta con archivos PDB> - Especifica las rutas de búsqueda en las que se deben buscar los archivos *.pdb (las rutas deben estar separadas por punto y coma; el resultado de la búsqueda es un archivo *.pdb con información simbólica, cuyo nombre coincide con el del ensamblado).
Estas claves no se crean en el registro de forma predeterminada. Si es necesario, el Administrador puede agregar estas claves al registro del sistema operativo del usuario. Para que los cambios en el registro surtan efecto, debe reiniciar el programa. Para depurar un ensamblado, debe conectarse al código administrado.