Al.exe Tool Errors and Warnings 

The following table lists the errors generated by Al.exe.

Error Description

al1001

Internal compiler error

Try to determine whether Al.exe is failing because of its inability to parse unexpected syntax. Then, contact Microsoft Product Support Services.

al1002

Out of memory

Al.exe ran out of memory and halted. Increase the amount of available memory.

al1003

Compiler option 'option' must be followed by an argument

Al.exe expected an argument to be passed to a command-line option. For example, if you specify /algid:, you must pass an algorithm identifier.

al1004

Unexpected common language runtime initialization error — 'reason'

Al.exe reported an error with the Visual Studio or common language runtime installation for the specified reason.

al1005

File 'file' too big to open

All files opened by Al.exe must be smaller than 4 gigabytes (GB).

al1006

Response file 'file' was already included

The same response file was specified (@file) more than once on the command line. The response file can only be included once.

al1007

Error opening response file 'file' — 'reason'

Al.exe cannot open the specified response file for the specified reason.

al1008

Missing file specification for 'option' command-line option

Al.exe expected a file to be passed to a command-line option. For example, if you specify the /out option, you must specify a file.

al1009

Can't open 'file' for writing

Al.exe was unable to write to a file, such as the output assembly file. The disk might be full, the file might be read-only, or you might not have access rights to the file.

al1010

Command-line syntax error: Missing ':text' for 'option' option

Al.exe expected an argument to be passed to a command-line option. For example, if you specify the /title option, you must pass a string.

al1011

File 'file' is an executable file and cannot be opened as a text file

A binary file was specified where a text file was expected. For example, this error occurs if a binary file is passed on the command line as a response file.

al1012

'value' is not a valid setting for option 'option'

An unexpected value was passed to a command-line option. For example, this error occurs if you specify an invalid value to the /target option.

al1013

Unrecognized command-line option: 'option'

An invalid command-line option was specified.

al1014

Unexpected initialization error — 'reason'

Al.exe detected a COM initialization failure. This might be caused by a lack of memory, but a more likely cause is your system DLL files. You should see a similar error if you run any Automation-aware or COM-aware program, such as Microsoft Visual Studio.

Reinstall your operating system.

al1015

Unable to find messages file 'alinkui.dll'

Al.exe requires Alinkui.dll. Make sure that this file is on your path. If necessary, copy it from the product CD.

al1016

No valid input files were specified

Al.exe requires one or more input files that do not have assembly information.

al1017

No target filename was specified

The required /out option specifying the target filename was missing.

al1018

Required file 'file' could not be loaded

Certain DLL files cannot be loaded. Reinstall Visual Studio or the Microsoft .NET Framework SDK.

al1019

Metadata failure while creating assembly — reason

Generation of the assembly was interrupted for the specified reason. For example, this error occurs if a file that you specify with the /win32res option is not found.

al1020

Ignoring included assembly 'file'

An input file that contained an assembly was specified. Al.exe input files cannot contain assemblies.

al1021

'setting' : overriding previous setting

A module had a value for a particular setting, possibly assigned through custom attributes, which was overridden with a value passed using an Al.exe command-line option.

al1022

Error reading embedded resource 'file' — reason

Al.exe cannot read the file passed to the /embedresource option for the specified reason.

al1023

Error embedding resource 'file' — reason

The operating system cannot embed the resource file in the assembly for the specified reason.

al1025

ComType record 'record' points to an invalid file record 'record'

Metadata in the input module is invalid. The tool that produced the module must be fixed.

al1026

The version specified 'version' is invalid

See information on the /version option for valid formats.

al1028

Key file 'file' is missing the private key needed for signing

A key file that contains only the public key was passed to the /keyfile option. Use the Strong Name Tool (Sn.exe) to generate a file with both a public and private key, as shown in the following command.

sn -k keypair.snk.

al1029

The key container name 'container' does not exist

The value passed to the /keyname option is not a valid container. Use the Strong Name Tool (Sn.exe) to create a container.

al1030

The cryptographic service is not installed properly or does not have a suitable key provider

You might need to either reinstall your operating system or install some cryptographic utility that was used in the creation of the key.

al1031

Error reading icon 'file' — reason

Al.exe cannot read the file that was passed to the /win32icon option for the specified reason

al1032

Error generating resources for 'file' — reason

Al.exe cannot create a file due to insufficient disk space or some other error. This error occurs when you specify the /win32icon option (which generates an .ico file) or do not specify the /win32res option (which generates a file with resource information).

If you cannot resolve the file generation problem, use /win32res, which specifies a file that can contain version or bitmap (icon) information.

al1033

Assembly custom attribute 'attribute' was specified multiple times with different values

Different values were passed to two occurrences of the same custom attribute in source modules that are specified as input to Al.exe.

al1034

Assembly 'file' cannot be copied or renamed

While using the Al.exe syntax that allows you to both specify an input file and copy it, a name conflict arose that stopped the compiler. For example, this error occurs if you specify input.dll,somename.dll /out:somename.dll.

al1035

Libraries cannot have an entry point

You cannot specify both the /target:lib option (the default) and the /main option.

al1036

Entry point required for executable applications

When using the /target:exe or /target:win option, you must also specify the /main option.

al1037

Unable to find the entry point method 'main'

Al.exe cannot find a Main method at the location specified by the /main option.

al1039

Initialization of global assembly cache manager failed — reason

Reinstall Visual Studio or the .NET Framework SDK.

al1040

Failed to install assembly into cache — reason

Only signed assemblies can be installed into the cache. See Global Assembly Cache for more information.

al1041

'method': cannot be the entry point because the signature or visibility is incorrect, or it is generic

A method was specified with the /main option, but that method is not static, does not return int or void, was generic, or has invalid arguments.

al1042

'exe': EXEs cannot be added modules

An .exe file that does not have an assembly was specified as an input file to Al.exe. Al.exe can only take .dll files without assemblies as input files.

al1043

Manifest file name 'name' cannot be the same as any modules

The name specified with the /out option cannot be the same as any of the file names that are specified as input to Al.exe.

al1044

Error reading key file 'file' — reason

An error occurred while opening or reading from a file specified with /keyfile or the AssemblyKeyFileAttribute.

al1045

Filename 'file' is too long or invalid

A file name longer than 260 characters was passed to Al.exe. Choose a file name with fewer characters or a shorter path, or rename the file.

al1046

Resource identifier 'ID' has already been used in this assembly

Two resources, embedded or linked, have the same identifier or name (the second argument). Remove or rename one of the conflicting resources.

al1047

Error importing file 'file' — reason

A module file cannot be opened for the specified reason.

al1048

Error importing module 'module' of assembly 'assembly' — reason

An error occurred when opening a nonmanifest file of a multifile assembly. This error is not emitted directly by Al.exe, but can be passed programmatically to a process that uses Al.exe.

al1049

Cannot auto-generate build and revision version numbers for dates previous to January 1, 2000

The system clock on your computer is set to a date earlier than January 1, 2000.

al1050

The feature you are using 'old feature' is no longer supported; please use 'new feature' instead

A feature previously supported by Al.exe is now obsolete. Use the recommended feature instead.

al1051

Error emitting 'attribute' attribute —'reason'

An assembly custom attribute was not processed by Al.exe for the specified reason.

al1052

File 'filename' is not an assembly

The file specified with /template must contain assembly metadata. This error indicates that the file specified by /template did not contain an assembly.

al1053

The version 'version' specified for the 'option' is not in the normal 'major.minor.build.revision' format

Al.exe detected ill-formed version information specified with the /fileversion or /productversion options.

al1054

The version 'version' specified for the 'option' is not in the normal 'major.minor.build.revision' format

Al.exe detected ill-formed version information specified with the SatelliteContractVersionAttribute.

al1055

Referenced assembly 'filename' does not have a strong name

This error is issued when you are building an assembly with a strong name and reference an assembly that does not have a strong name. To fix this, you need to either regenerate your assembly with a strong name, or attach a strong name to the assembly using sn.exe (see the documentation for sn.exe).

A common occurrence of this error is when you are using COM objects via wrapper assemblies, such as when you add a reference to a COM module to a C# project via the VS IDE. To avoid the error, you can specify the strong name key file for COM wrapper assemblies in the Project Property "Wrapper Assembly Key File/Name"

If you are creating the wrapper assembly via tlbimp, see the tlbimp documentation for information on how to assign a strong name to the wrapper assembly.

If an assembly has a strong name, it can be installed in the global assembly cache. Consequently, referenced assemblies would also need to go into the global assembly cache. Only assemblies with strong names can go into the global assembly cache.

al1056

Referenced assembly 'filename' is a localized satellite assembly

An assembly created using the AssemblyCultureAttribute attribute was referenced in the creation of the current assembly. The AssemblyCultureAttribute attribute indicates the file is a localized satellite assembly and it is not normal to reference a satellite assembly. You should probably reference the main parent assembly instead.

al1057

Executables cannot be localized, Culture should always be empty

An assembly is being created with /target:exe but /culture was specified. Assemblies in the .exe cannot have information in the Culture field.

al1058

'file' is an assembly and cannot be added as a module

In a C++ compilation, /assemblymodule (linker option) was passed a file that contained an assembly.

al1059

Unknown error (code)

Al.exe received an unknown error code (code).

Possible solutions include:

  • Reinstall Visual Studio.

  • Reinstall the .NET Framework SDK.

  • Check for missing files.

  • Check for adequate disk space.

  • Check for adequate memory.

  • Stop other processes that might be accessing the files.

  • Reboot your computer.

al1060

Cryptographic failure while creating hashes — reason

An error occurred while creating the file hashes for a multifile assembly.

al1061

Cannot set option 'option' because 'reason'

The value specified for this option is invalid for the specified reason.

al1062

Module 'module' was specified multiple times; it will only be included once

This warning is generated when the same source, input, or module file is specified multiple times on the command line. Make sure you specify the file name only once.

al1063

Public type 'type' is defined in multiple places in this assembly: 'file1' and 'file2'

The same type was found in more than one module within the assembly. Only one version of each type may be present in an assembly.

al1064

Cannot specify multiple /bugreport options.

Only one /bugreport option is allowed.

al1065

File name 'File Name' is too long or invalid

The specified file name is longer than the maximum allowed.

al1066

Character 'character' is not allowed on the command-line or in response files

An invalid character was found, either on the command line or in a file.

al1067

'filename' is a binary file instead of a text file

The file is in binary format instead of text.

al1068

Module 'ModuleName' is already defined in this assembly. Each linked resource and module must have a unique filename.

The module occurs more than once in this assembly.

al1069

Cannot create short filename 'filename' when a long filename with the same short filename already exists

The current file has a name that is the short version of a file name that already exists. For example, compiling LongFileName.cs and then recompiling with the name LongFi~1.cs will cause a compiler error similar to this. If the compiler output files with long names were deleted, but the analogous linker files remained, this error could occur.

al1070

Agnostic assembly cannot have a processor specific module 'Module Name'

If you are building using /platform:agnostic (or you don’t specify /platform), an error will be generated if you try to add a module (using /addmodule) that is not agnostic. This is similar to trying to link an i386 obj file with an ia64 obj.

The main source of non-agnostic modules is C++. If you are using /addmodule with a C++ module, you may have to modify your build scripts to specify the appropriate /platform setting.

al1072

Assembly and module 'Module Name' cannot target different processors

You cannot link together an assembly and a module that are targeted for different processors, because the result has to run on a single processor.

al1073

Referenced assembly 'assembly' targets a different processor

You cannot link together assemblies that are targeted for different processors, because the result has to run on a single processor.

al1074

Module name 'Module Name' stored in 'File Name' must match its filename

This is a requirement of the linker. To resolve this problem, make the two names match.

al1075

Delay signing was requested, but no key was given

When an assembly is delay signed, the compiler does not compute and store the signature, but reserves space in the file so the signature can be added later.

For example, using /delaysign+ allows a tester to put the assembly in the global cache. After testing, you can fully sign the assembly by placing the private key in the assembly using the Assembly Linker utility.

al1076

Type 'type' is forwarded to multiple assemblies: 'assembly' and 'assembly'.

A type can only be forwarded to one assembly.

al1077

Public type 'type' is defined in 'assembly' and forwarded to 'assembly'.

There is a duplicate public type in the assembly being generated. One is a valid type definition and the other is a type forwarder.

See Also

Reference

.NET Framework Tools
Assembly Linker (Al.exe)
SDK Command Prompt