Advanced Page (.NET Interop Assembly Properties Dialog Box)

LabVIEW 2018 Help


Edition Date: March 2018
Part Number: 371361R-01
View Product Info

DOWNLOAD (Windows Only)


LabVIEW 2015 Help
LabVIEW 2016 Help
LabVIEW 2017 Help
LabVIEW 2018 Help
LabVIEW 2019 Help

Requires: Application Builder or Professional System (Windows)

Use this page of the .NET Interop Assembly Properties dialog box to change advanced settings for a .NET interop assembly.

This page includes the following components:

  • Enable debugging—Enables debugging for the application, shared library, .NET interop assembly, or Web service.
    Note  Disabling this checkbox does not ensure full optimization.
    • Wait for debugger on launch—Sets the application, shared library, or .NET interop assembly to load but not run until the user enables it to run through the LabVIEW debugging controls. Place a checkmark in the Enable debugging checkbox to enable this option.
  • Copy error code files—Adds copies of XML-based LabVIEW error code text files from the project\errors and user.lib\errors directories to the run-time engine.
    Note  You must manually create an errors folder in the labview\user.lib directory to organize your error code files.
  • Use custom aliases file—Copies the project aliases file with the application, shared library, or .NET interop assembly. If you place a checkmark in the checkbox, the Select Project File dialog box appears and you can select an aliases file in the project.
    • Aliases file in project—Specifies the aliases file to use with the application, shared library, or .NET interop assembly if you select Use custom aliases file.
      • Browse Project—Displays the Select Project File dialog box, which you can use to select an aliases file.
  • Enable Enhanced DSC Run-Time support—This option only appears if you have the LabVIEW Datalogging and Supervisory Control (DSC) Module installed. Builds the application with the enhanced DSC Module Run-Time Engine. The DSC Module Run-Time Engine adds additional support for programmatic project library and shared variable management in applications that you build with the DSC Module. You must place a checkmark in this checkbox in the following situations:
    • The application you want to build uses VI Server references to modify a library file programmatically.
    • The application you want to build uses the Save to Library VI.

    If you do not enable the enhanced DSC Module Run-Time Engine in these two situations, LabVIEW returns error code 1055 when you run the built application, shared library, or .NET interop assembly.
    Note  Enabling this option increases the file size and reduces the start-up performance of the built application, shared library, or .NET interop assembly.
  • Enable strong name signing—Specifies whether to sign the assembly with a strong name key file. The signing of application and deployment manifests is a process distinct from the signing of an assembly. Also, the storage of key file information differs for manifest signing and assembly signing. For manifest signing, key information is stored in the cryptographic storage database and the Windows certificate store for the current user. For assembly signing, key information is stored only in the cryptographic storage database.
    Note  Refer to the KnowledgeBase at ni.com for more information about using a strong name key file to sign the .NET assembly.
    • Strong name key file in project—Specifies an existing strong name key file to sign the assembly. Click the Browse Project button to display the Select Project File dialog box, which you can use to select a key file.
  • Generate build log file—Specifies whether to create a log file for the build. The build log file lists all files contained in the build, including subVIs you do not specify as Exported VIs or Always Included on the Source Files page. The log file also contains general build information such as build start and end time, the build specification and project name, and any errors that occurred during the build.
    • Log file path—Specifies the path to save the build log file.
  • LabVIEW 2011 compatibility mode—Specifies whether to generate the assembly using the same style as assemblies built in LabVIEW 2011 and earlier. Disable this checkbox to generate the assembly using the style of LabVIEW 2012 and later. If you migrate a build specification created in LabVIEW 2011 or earlier, this checkbox contains a checkmark by default. Disabling this checkbox might cause unintended errors if pre-existing code relies on the migrated build specification. The following table lists how each style changes the generated assembly.

    LabVIEW 2011 compatibility mode LabVIEW 2012 and later
    Generated methods use the default refnum class and are not type safe. Generated methods use type-safe refnum classes.
    The generated method prototype lists output parameters before input parameters. The generated method prototype lists parameters according to their arrangement on the VI connector pane. Inputs appear first, arranged according to the order of the terminals on the connector pane from top to bottom, left to right. Outputs appear after inputs, arranged according to the order of the terminals on the connector pane from top to bottom, right to left.
    All methods generated from Vis belong to a single class specified in the .NET interop assembly class name section on the Information page of the .NET Interop Assembly Properties dialog box. If a VI belongs to a project library, then the .NET method generated from that VI belongs to a class with the same name as the project library. For nested project libraries, LabVIEW generates nested classes. If a VI does not belong to a project library, the .NET method generated for this VI belongs to the class specified in the .NET interop assembly class name section on the Information page of the .NET Interop Assembly Properties dialog box.
    Methods generated from Vis containing error in and error out clusters include error in and error out parameters. .NET methods do not typically accept and return errors. When LabVIEW generates a .NET method for a VI, LabVIEW does not export the error in and error out clusters as parameters of the new method. Instead, the new method throws a .NET exception if an error occurs while the method is executing. This exception contains the same information as the error cluster.
  • Allow future versions of LabVIEW to load this .NET assembly—Enables this .NET interop assembly to load with future versions of the LabVIEW Run-Time Engine. You can disable this option to bind a build specification to a specific version of LabVIEW. Disabling this option prevents any changes to the performance profiles and helps you avoid unexpected problems resulting from compiler upgrades.



Building and Distributing Applications Home

WAS THIS ARTICLE HELPFUL?

Not Helpful