.NETMODULE-файлы в качестве входных файлов компоновщика
Обновлен: Ноябрь 2007
Программа link.exe теперь принимает в качестве входных данных OBJ-файлы и NETMODULE MSIL. Выходным файлом компоновщика будет являться сборка или NETMODULE-файл, не имеющие зависимости времени выполнения от каких-либо входных файлов компоновщика OBJ или NETMODULE.
. NETMODULE-файлы создаются с использованием компилятора Visual C++ с параметром /LN (создание модуля MSIL) или с использованием компоновщика с параметром /NOASSEMBLY (создать модуль MSIL). .OBJ-файлы всегда создаются при компиляции в Visual C++. Для других компиляторов Visual Studio используется параметр компилятора /target:module.
В большинстве случаев необходимо передать компоновщику OBJ-файл, созданный при выполнении той же компиляции, что и NETMODULE-файл, если только NETMODULE не был создан с помощью /clr (компиляция CLR). NETMODULE-файлы MSIL, используемые как входные файлы компоновщика, должны содержать чистый код MSIL, который может быть получен с помощью компоновщика Visual C++ с указанием параметра /clr:safe. Другие компиляторы Visual Studio создают модули MSIL по умолчанию.
Сведения о запуске компоновщика из командной строки см. в разделах Синтаксис командной строки компоновщика и Установка переменных пути и среды при построении из командной строки.
Передача компоновщику NETMODULE-файла или DLL, скомпилированного с помощью компилятора Visual C++ с указанием параметров /clr или /clr:pure, может привести к ошибке компоновщика. Дополнительные сведения см. в разделе Выбор формата входных файлов netmodule.
Компоновщик принимает машинные OBJ-файлы, а также OBJ-файлы на языке MSIL, скомпилированные с использованием параметров /clr, /clr:pure или /clr:safe. При передаче смешанных OBJ-файлов в одном построении проверяемость результирующих выходных файлов будет равна по умолчанию минимальному уровню проверяемости входных модулей. Например, при передаче компоновщику надежного и чистого OBJ-файла выходной файл будет чистым. Параметр /CLRIMAGETYPE (указание типа образа среды CLR) позволяет указывать при необходимости минимальный уровень проверяемости.
При наличии приложения, состоящего из двух или нескольких сборок, которое необходимо объединить в одну сборку, следует перекомпилировать сборку и затем произвести компоновку OBJS-файлов или NETMODULE-файлов, чтобы получить единую сборку.
При создании исполняемого образа необходимо задать точку входа с помощью параметра /ENTRY (символ точки входа).
При связывании с OBJ-файлом или NETMODULE-файлом MSIL используйте параметр Параметр /LTCG (создание кода во время компоновки); в противном случае при обнаружении компоновщиком OBJ-файла или NETMODULE MSIL компоновка будет перезапущена с параметром /LTCG.
OBJ-файлы или NETMODULE MSIL также могут быть переданы компилятору.
OBJ-файлы или NETMODULE MSIL не могут иметь внедренные ресурсы. Ресурс внедряется в выходной файл (модуль или сборку) с помощью параметра компилятора /ASSEMBLYRESOURCE (внедрение управляемого ресурса) или параметра компилятора /resource для других компиляторов Visual Studio.
При выполнении компоновки MSIL, если не указать также параметр Параметр /LTCG (создание кода во время компоновки), будет выведено информационное сообщение, уведомляющее о перезапуске компоновки. Это сообщение можно проигнорировать, но в целях повышения производительности компоновки MSIL следует явно задать параметр /LTCG.
Пример
В коде на языке C++ блок catch, связанный с соответствующим try, будет вызван при возникновении несистемного исключения. Однако по умолчанию среда CLR упаковывает несистемные исключения с помощью RuntimeWrappedException. При создании сборки из модулей Visual C++ и не-Visual C++ и необходимости вызова блока catch в коде C++ из соответствующей конструкции try при создании блоком try несистемного исключения следует добавить атрибут
[assembly:System::Runtime::CompilerServices::RuntimeCompatibility(WrapNonExceptionThrows=false)] в исходный код модулей, написанных не на языке C++.
// MSIL_linking.cpp
// compile with: /c /clr
value struct V {};
ref struct MCPP {
static void Test() {
try {
throw (gcnew V);
}
catch (V ^) {
System::Console::WriteLine("caught non System exception in C++ source code file");
}
}
};
/*
int main() {
MCPP::Test();
}
*/
Путем изменения логического значения WrapNonExceptionThrows можно управлять способностью кода на языке Visual C++ перехватывать несистемные исключения.
// MSIL_linking_2.cs
// compile with: /target:module /addmodule:MSIL_linking.obj
// post-build command: link /LTCG MSIL_linking.obj MSIL_linking_2.netmodule /entry:MLinkTest.Main /out:MSIL_linking_2.exe /subsystem:console
using System.Runtime.CompilerServices;
// enable non System exceptions
[assembly:RuntimeCompatibility(WrapNonExceptionThrows=false)]
class MLinkTest {
public static void Main() {
try {
MCPP.Test();
}
catch (RuntimeWrappedException) {
System.Console.WriteLine("caught a wrapped exception in C#");
}
}
}
caught non System exception in C++ source code file