.netmodule pliki jako dane wejściowe konsolidatora

  • Artykuł

plik link.exe akceptuje uwierzytelnianie MSIL .obj i .netmodule pliki jako dane wejściowe. Plik wyjściowy utworzony przez konsolidator jest zestawem lub plikiem .netmodule bez zależności czasu wykonywania od żadnego z .obj plików lub .netmodule , które były danymi wejściowymi konsolidatora.

Uwagi

.netmodule pliki są tworzone przez kompilator MSVC za pomocą /LN (Tworzenie modułu MSIL) lub przez konsolidator z /NOASSEMBLY (Tworzenie modułu MSIL). .obj pliki są zawsze tworzone w kompilacji języka C++. W przypadku innych kompilatorów programu Visual Studio użyj opcji /target:module kompilatora.

Konsolidator musi zostać przekazany .obj plik z kompilacji języka C++, która utworzyła .netmoduleplik . Przekazywanie elementu .netmodule nie jest już obsługiwane, ponieważ opcje kompilatora /clr: i /clr:safepure są przestarzałe w programie Visual Studio 2015 i nieobsługiwane w programie Visual Studio 2017 lub nowszym.

Aby uzyskać informacje na temat wywoływania konsolidatora z wiersza polecenia, zobacz Składnia wiersza polecenia konsolidatora konsolidatora i Używanie zestawu narzędzi MSVC z wiersza polecenia.

Przekazanie pliku .netmodule lub .dll do konsolidatora skompilowanego przez kompilator MSVC za pomocą polecenia /clr może spowodować błąd konsolidatora. Aby uzyskać więcej informacji, zobacz Wybieranie formatu plików wejściowych .netmodule

Konsolidator akceptuje zarówno pliki natywne .obj , jak i pliki MSIL .obj skompilowane za pomocą polecenia /clr. W tej samej kompilacji można przekazać mieszane .obj pliki. Domyślna weryfikowalność wynikowego pliku wyjściowego jest taka sama jak weryfikowalność najniższego modułu wejściowego.

Możesz zmienić aplikację składającą się z co najmniej dwóch zestawów, które mają być zawarte w jednym zestawie. Ponownie skompiluj źródła zestawów, a następnie połącz .obj pliki lub .netmodule pliki w celu utworzenia pojedynczego zestawu.

Określ punkt wejścia przy użyciu /ENTRY (symbol punktu wejścia) podczas tworzenia obrazu wykonywalnego.

Podczas łączenia z MSIL lub pliku użyj /LTCG (generowanie kodu czasu łącza), w przeciwnym razie gdy konsolidator napotka MSIL .obj.obj lub .netmodule, uruchomi ponownie link z /LTCG..netmodule Zostanie wyświetlony komunikat informacyjny informujący o ponownym uruchomieniu linku. Możesz zignorować ten komunikat, ale aby poprawić wydajność konsolidatora, jawnie określ /LTCG.

Plik MSIL .obj lub .netmodule pliki można również przekazać do pliku cl.exe.

Dane wejściowe MSIL .obj lub .netmodule pliki nie mogą mieć zasobów osadzonych. Osadź zasoby w module wyjściowym lub pliku zestawu przy użyciu opcji konsolidatora /ASSEMBLYRESOURCE (Osadź zasób zarządzany). Możesz też użyć opcji /resource compiler w innych kompilatorach programu Visual Studio.

Przykłady

W kodzie catch języka C++ blok odpowiadający try mu zostanie wywołany dla wyjątku innego niżSystem . Jednak domyślnie CLR opakowuje wyjątki inne niżSystem .RuntimeWrappedException Gdy zestaw jest tworzony na podstawie modułów C++ i innych niż C++, a blok w kodzie C++ ma catch być wywoływany z odpowiedniej try klauzuli, gdy try blok zgłaszaSystem wyjątek inny niż C++, należy dodać [assembly:System::Runtime::CompilerServices::RuntimeCompatibility(WrapNonExceptionThrows=false)] atrybut do kodu źródłowego dla modułów innych niż 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();
}
*/

Boolean Zmieniając wartość atrybutuWrapNonExceptionThrows, można zmodyfikować możliwość przechwycenia kodu C++, aby przechwycićSystem wyjątek.

// 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

Zobacz też