ViewArticle

[Collapse]Automated Build Studio/viewarticle/9302/
 [Expand]Introduction/viewarticle/9304/
 [Expand]Getting Started/viewarticle/9312/
 [Expand]Working With Automated Build Studio/viewarticle/9325/
 [Collapse]Operations Reference/viewarticle/9623/
   Common Operation Properties/viewarticle/9386/
  [Collapse].NET Tools/viewarticle/9933/
    CLRxLint Operation/viewarticle/10157/
    Configure ASP.NET Operation/viewarticle/9659/
    Dotfuscator Operation/viewarticle/9751/
    Edit Assembly Information Operation/viewarticle/9663/
    Extract Public Key Operation/viewarticle/10551/
    Fix COM References Operation/viewarticle/10254/
    FxCop Operation/viewarticle/10550/
    GAC Iterator Operation/viewarticle/10553/
    Generate Key Pair Operation/viewarticle/10555/
    Get Assembly Info Operation/viewarticle/9664/
    ILMerge Operation/viewarticle/10200/
    Install/Uninstall Assembly Operation/viewarticle/10556/
    Install/Uninstall Key Operation/viewarticle/10552/
    InstallUtil Operation/viewarticle/10154/
    Manifest Generation and Editing Operation/viewarticle/10262/
    Native Image Generator Operation/viewarticle/9698/
    Register/Unregister Assembly Operation/viewarticle/10557/
    Re-sign Assembly Operation/viewarticle/10554/
    Resources Generator Operation/viewarticle/10273/
    Run AL.EXE Operation/viewarticle/10256/
    Run SN.EXE Operation/viewarticle/10243/
    Verify Strong Name Operation/viewarticle/10558/
    Wise Owl Demeanor Operation/viewarticle/9855/
    XenoCode Operation/viewarticle/10549/
    Xenocode Postbuild 2008 Operation/viewarticle/10287/
  [Expand]ADO/viewarticle/10368/
  [Expand]Amazon EC2/viewarticle/22737/
  [Expand]Archivers/viewarticle/9794/
  [Expand]Authenticode/viewarticle/10217/
  [Expand]Build Tools/viewarticle/10156/
  [Expand]Borland Compilers/viewarticle/9679/
  [Expand]Burn CD/DVD/viewarticle/10301/
  [Expand]Communication/viewarticle/10094/
  [Expand]Concurrent Versions System/viewarticle/9634/
  [Expand]Embarcadero Compilers/viewarticle/63530/
  [Expand]Encrypting File System/viewarticle/10352/
  [Expand]Execute/viewarticle/10365/
  [Expand]Files and Directories/viewarticle/10107/
  [Expand]Frequently Used/viewarticle/10195/
  [Expand]FTP/viewarticle/10093/
  [Expand]Help Compilers/viewarticle/10109/
  [Expand]HTTP/viewarticle/10092/
  [Expand]Installers/viewarticle/9795/
  [Expand]Interactive/viewarticle/9504/
  [Expand]Internet Information Services (IIS)/viewarticle/9964/
  [Expand]Issue Tracking/viewarticle/9472/
  [Expand]JediVCS/viewarticle/9949/
  [Expand]Logging/viewarticle/10210/
  [Expand]Mercurial/viewarticle/10353/
  [Expand]Microsoft Compilers/viewarticle/9676/
  [Expand]Microsoft Compilers for Smart Device/viewarticle/9675/
  [Expand]Microsoft Hyper-V/viewarticle/42211/
  [Expand]Microsoft Source Server/viewarticle/10291/
  [Expand]Microsoft SQL Server/viewarticle/9882/
  [Expand]Microsoft Virtual PC/viewarticle/10015/
  [Expand]Microsoft Virtual Server/viewarticle/9508/
  [Expand]Microsoft Visual SourceSafe/viewarticle/9626/
  [Expand]Misc/viewarticle/10263/
  [Expand]MySQL/viewarticle/9885/
  [Expand]Oracle/viewarticle/10203/
  [Expand]Other Compilers/viewarticle/9677/
  [Expand]Patch Management/viewarticle/10167/
  [Expand]Perforce/viewarticle/9624/
  [Expand]Prepare Code/viewarticle/10134/
  [Expand]PsTools/viewarticle/9720/
  [Expand]PVCS/viewarticle/9632/
  [Expand]Rational ClearCase/viewarticle/9629/
  [Expand]Read/Write/viewarticle/10241/
  [Expand]Remote Macro Execution/viewarticle/9369/
  [Expand]Serena Dimensions/viewarticle/10364/
  [Expand]SmartBear and AutomatedQA Tools/viewarticle/10098/
  [Expand]Source Code Tools/viewarticle/10194/
  [Expand]SourceGear Vault/viewarticle/9625/
  [Expand]SourceOffSite/viewarticle/9633/
  [Expand]Standard/viewarticle/10212/
  [Expand]StarTeam/viewarticle/9622/
  [Expand]String Manipulation/viewarticle/10308/
  [Expand]Subversion/viewarticle/9628/
  [Expand]Surround SCM/viewarticle/9621/
  [Expand]Team Coherence/viewarticle/9471/
  [Expand]Team Foundation Version Control/viewarticle/9608/
  [Expand]Unit Tests/viewarticle/10115/
  [Expand]User Interface Actions/viewarticle/10346/
  [Expand]VMware Server/viewarticle/10008/
  [Expand]VMware vSphere/viewarticle/42215/
  [Expand]VMware Workstation/viewarticle/9913/
  [Expand]Wait/viewarticle/9994/
  [Expand]WMI/viewarticle/10136/
  [Expand]XML/viewarticle/9702/
 [Expand]Technical Support and Resources/viewarticle/9314/
 [Expand]Other Tools for Improving Your Build Processes/viewarticle/42205/
Updated: 1/9/2014 Applies To: Automated Build Studio 6 Rating: No votes Click to rate: PoorNot badAverageGoodExcellent
.NET Tools Operations

Native Image Generator Operation

The Native Image Generator operation lets you generate native images for an assembly and its dependencies and installs them to the native image cache on the current computer, updates the native images that have become invalid or uninstalls the native images for an assembly and its dependencies.

Requirements

The operation uses the Native Image Generator tool (ngen.exe), which is a part of the Microsoft .NET Framework. Therefore, in order for the operation to execute successfully, the .NET Framework must be installed on your computer. Otherwise, an error will occur.

Child Operations

The operation cannot have child operations.

Operation Properties

The operation properties are organized into the following pages:

Properties

This page contains properties common for all operations. For more information on them, see Properties That Are Common for All Operations. We would like to draw your attention to the Timeout property on this page:

Timeout

The purpose of this property is to stop Native Image Generator if it is working too long and probably has frozen. When the operation execution reaches the timeout limit, Automated Build Studio closes the Native Image Generator instance started by the operation. Using the operation's Timeout property is one of two ways to set the timeout limit for operations. Besides the operation's Timeout property, you can use the timeout common for all operations in the macro (see Macro Properties Dialog).

Native Image Generator Details

.NET Framework version

Required. The Native Image Generator operation uses the ngen.exe utility that is shipped with the .NET Framework SDK (see the note on this at the beginning of the topic). This property specifies the version of the SDK whose ngen.exe should be used. You can either enter the version manually or press the ellipsis button and select the needed version in the resulting Select .NET Framework Version dialog. Alternatively, you can specify an existing variable or constant that holds the desired version. To specify the property values, you can also use the single-lined scripts.

Assembly

Required. Specifies the name (including the full path) of the assembly file that the operation will work with. For instance, C:\Program Files\MyApplication\MyAssembly.dll. To choose the assembly file via the standard Open File dialog, press the button.

If the assembly resides in the GAC (Clobal Assembly Cache), you can specify the full display name of the assembly, for example, MyAssembly, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0038abc9deabfle5. If you choose the Uninstall native images option in the Action property, you can specify a partial display name (for instance, MyAssembly) rather than the full name. You can enter the assembly’s display name manually or press the ellipsis button and use the resulting Assembly Name Editor to form this name.

Instead of specifying the assembly name or path itself, you can choose an existing variable or constant that holds it. To specify the property values, you can also use the single-lined scripts.

Action

Required. Specifies the action to be performed by the operation. The following options are available:

Install native images

If this property is selected, the operation will generate native images for the Assembly and its dependencies and install the images in the native image cache.

Uninstall native images

If this property is selected, the operation will delete native images of the Assembly and its dependencies from the native image cache.

Update native images

If this property is selected, the operation will update native images that have become invalid.

This property only works for .NET Framework v. 2.0 and later.

Queue for the native image service

If this property is checked, the generation and update of native images will be queued for execution by the native image service with the priority specified by the Priority property. This property is available only if the Action property has the Install native images or Update native images value.

This property only works for .NET Framework v. 2.0 and later.

Priority

Optional. Specifies the queue priority for the image generation. Possible values: 1 (highest priority) up to 3 (lowest priority). The default value is 3, which means that the action will be run when the computer is idle. You can enter the desired priority value or choose an existing variable or constant that holds it. To specify the property values, you can also use the single-lined scripts.

Note: If the Action property has the Update native images value, the action will be queued at priority 3 discarding the Priority property value.
Options

Scenario

This group contains properties that specify the scenarios that the operation should generate or affect.

Generate native images that can be used under a debugger

Specifies that the operation should generate or affect the set of native images that include debugging information.

Generate native images that can be used under a profiler

Specifies that the operation should generate or affect the set of native images that include profiling information.

Generate the minimum number of native images

If this option is checked, the operation generates the minimum number of native images required by the specified scenario options.

This property only works for .NET Framework v. 2.0 and later.

Configuration

This group contains properties that specify how the operation processes the assembly dependencies.

Use the configuration of the specified assembly

Optional. Specifies the full name (including the path) of the executable file with the configuration information that determines dependencies loaded at run time. You can enter the file name manually, or press the ellipsis button and choose the desired file in the subsequent Open File dialog. Alternatively, you can specify an existing variable or constant that holds the file name. To specify the property values, you can also use the single-lined scripts.

This property works only for .NET Framework v. 2.0 and later.

Use the following directory when locating dependencies

Optional. Specifies the directory that will be used as the application base when locating dependencies. If this property is not specified, the operation will use the directory that contains the assembly as the base directory. You can enter the path to the directory manually, or press the ellipsis button and choose the desired directory in the standard Browse for Folder dialog. You can also specify an existing variable or constant that holds this path to the directory. To specify the property values, you can also use the single-lined scripts.

This property only works for .NET Framework v. 2.0 and later.

Remarks

You can use variables and constants to set values of operation properties. When specifying the variable (or constant) name, enclose it in the % symbols, for instance, %VariableName%. See Using Variables and Constants in Operation Properties.

See also
.NET Tools Operations | Specifying Operation Properties


© 2018 SmartBear Software. All rights reserved.
Email Send feedback on this document