Preload CLR (-preloadCLR)
- Last Updated: February 9, 2026
- 1 minute read
- OpenEdge
- Version 12.8
- Documentation
Preload CLR (-preloadCLR)
Use Preload CLR (-preloadCLR)
to load the .NET Common Language Runtime (CLR) and any specified
assemblies into the ABL session at startup. This provides for deterministic
loading of the CLR and assemblies when the application is started.
| Operating system and syntax | Windows / Linux |
-preloadCLR
|
||
|---|---|---|---|---|
| Use with | Maximum value | Minimum value | Single-user default | Multi-user default |
| Client Session | — | — | — | — |
If you do not specify -preloadCLR, the AVM
loads the CLR the first time ABL refers to, or uses, a .NET type or object either at compile
time or runtime. All of the assemblies listed in the assemblies.xml
file are loaded at once.
If you specify -preloadCLR and the client
machine does not have an appropriate version of .NET installed, OpenEdge raises an error
and shuts down.
On Linux, if you specify -preloadCLR, you must also use
.NET Common Language Runtime (-clrnetcore).
If you specify -preloadCLR, you cannot also specify No Common Language Runtime (-noclr).
For more information about accessing .NET objects using ABL, see Use .NET Classes in ABL Applications. For information about the .NET CLR, refer to the .NET documentation.