Udostępnij za pośrednictwem

Ilasm.exe (Asembler IL)

Asembler IL generuje przenośny plik wykonywalny (PE) z zestawu języka pośredniego (IL). (Aby uzyskać więcej informacji na temat IL, zobacz Zarządzany proces wykonywania). Możesz uruchomić wynikowy plik wykonywalny, który zawiera il i wymagane metadane, aby określić, czy IL działa zgodnie z oczekiwaniami.

To narzędzie jest instalowane automatycznie z programem Visual Studio. Aby uruchomić narzędzie, użyj wiersza polecenia dla deweloperów programu Visual Studio lub programu Visual Studio Developer PowerShell.

W wierszu polecenia wpisz:

Składnia

ilasm [options] filename [[options]filename...]

Parametry

Argument opis
filename Nazwa pliku źródłowego il. Ten plik zawiera dyrektywy deklaracji metadanych i symboliczne instrukcje języka IL. W celu utworzenia pojedynczego pliku PE z Ilasm.exe można podać wiele argumentów pliku źródłowego. Uwaga: Upewnij się, że ostatni wiersz kodu w pliku źródłowym il ma znak końcowy biały lub znak końca wiersza.
Opcja Opis
/32bitpreferred Tworzy obraz 32-bitowy (PE32).
/wyrównanie: integer Ustawia wartość FileAlignment na wartość określoną w integer nagłówku NT Optional. Jeśli dyrektywa języka IL .alignment została określona w pliku, ta opcja zastępuje ją.
/appcontainer Tworzy plik .dll lub .exe uruchamiany w kontenerze aplikacji systemu Windows jako dane wyjściowe.
/ramię Określa procesor Advanced RISC Machine (ARM) jako procesor docelowy.

Jeśli nie określono bitowości obrazu, wartość domyślna to /32bitpreferred.
/baza: integer Ustawia parametr ImageBase na wartość określoną przez integer w nagłówku NT Optional. Jeśli dyrektywa języka IL .imagebase została określona w pliku, ta opcja zastępuje ją.
/zegar Mierzy i raportuje następujące czasy kompilacji (w milisekundach) dla określonego pliku źródłowego il:

Łączny przebieg: łączny czas spędzony na wykonywaniu wszystkich kolejnych operacji.

Uruchamianie: ładowanie i otwieranie pliku.

Emitowanie md: emitowanie metadanych.

Ref to Def Resolution: Rozpoznawanie odwołań do definicji w pliku.

Generacja plików CEE: Generowanie obrazu pliku w pamięci.

Zapisywanie pliku PE: zapisywanie obrazu w pliku PE.
/debug[:IMPL|OPT] Dołącza informacje o debugowaniu (zmienne lokalne, nazwy argumentów i numery wierszy). Tworzy plik PDB.

/debug bez dodatkowej wartości wyłącza optymalizację JIT i używa punktów sekwencji z pliku PDB.

Usługa IMPL wyłącza optymalizację JIT i używa niejawnych punktów sekwencji.

Opt umożliwia optymalizację trybu JIT i używa niejawnych punktów sekwencji.
/Dll Tworzy plik .dll jako dane wyjściowe.
/Enc: file Tworzy plik różnic Edytuj-i-Kontynuuj z określonego pliku źródłowego.

Ten argument jest tylko do użytku akademickiego i nie jest obsługiwany w użytku komercyjnym.
/exe Tworzy plik wykonywalny jako dane wyjściowe. Jest to opcja domyślna.
/Flagi: integer Ustawia parametr ImageFlags na wartość określoną przez integer w nagłówku środowiska uruchomieniowego języka wspólnego. Jeśli dyrektywa języka IL .corflags została określona w pliku, ta opcja zastępuje ją. Zobacz CorHdr.h, COMIMAGE_FLAGS, aby uzyskać listę prawidłowych wartości dla liczby całkowitej.
/fałda Składa identyczne treści metod w jedną.
/highentropyva Tworzy wyjściowy plik wykonywalny, który obsługuje generowanie losowe układów przestrzeni adresowej (ASLR) o wysokiej entropii. (Wartość domyślna dla /appcontainer).
/zawierać: includePath Ustawia ścieżkę do wyszukiwania plików dołączonych do #includeelementu .
/itanium Określa procesor Intel Itanium jako procesor docelowy.

Jeśli nie określono bitowości obrazu, wartość domyślna to /pe64.
/klucz: keyFile Kompiluje filename z silnym podpisem przy użyciu klucza prywatnego zawartego w pliku keyFile.
/klucz: @keySource Kompiluje filename się przy użyciu silnego podpisu przy użyciu klucza prywatnego utworzonego w pliku keySource.
/Aukcji Tworzy plik listy w standardowym wyjściu. Jeśli ta opcja zostanie pominięta, plik listy nie zostanie utworzony.

Ten parametr nie jest obsługiwany w programie .NET Framework 2.0 i nowszych.
/mdv: versionString Ustawia ciąg wersji metadanych.
/msv: major.minor Ustawia wersję strumienia metadanych, gdzie major i minor są liczbami całkowitymi.
/noautoinherit Wyłącza dziedziczenie domyślne, Object gdy nie określono żadnej klasy bazowej.
/nocorstub Powoduje pominięcie generowania procedury wejścia CORExeMain.
/nologo Pomija wyświetlanie transparentu startowego firmy Microsoft.
/wyjście: file.ext Określa nazwę i rozszerzenie pliku wyjściowego. Domyślnie nazwa pliku wyjściowego jest taka sama jak nazwa pierwszego pliku źródłowego. Domyślne rozszerzenie to .exe. Jeśli określisz /dll opcji, domyślne rozszerzenie jest .dll. Uwaga: Określanie /output:myfile.dll nie ustawia /dll opcji. Jeśli nie określisz /dll, wynik będzie plikiem wykonywalnym o nazwie myfile.dll.
/optimize Optymalizuje długie instrukcje, co powoduje zamianę ich na krótkie. Na przykład br na br.s.
/pe64 Tworzy obraz 64-bitowy (PE32+).

Jeśli nie określono procesora docelowego, wartość domyślna to /itanium.
/pdb Tworzy plik PDB bez włączania śledzenia informacji o debugowaniu.
/quiet Określa tryb cichy; nie zgłasza postępów zestawu.
/zasób: file.res Zawiera określony plik zasobu w formacie *.res w wynikowym pliku .exe lub .dll . Można określić tylko jeden plik res z opcją /resource .
/ssver: int.int Ustawia numer wersji podsystemu w opcjonalnym nagłówku NT. W przypadku /appcontainer i /arm minimalny numer wersji to 6.02.
/stos: stackSize Ustawia wartość SizeOfStackReserve w nagłówku NT Optional na stackSizewartość .
/stripreloc Określa, że nie są potrzebne relokacje podstawowe.
/Podsystemu: integer Ustawia podsystem na wartość określoną przez integer w nagłówku opcjonalnym NT. Jeśli dyrektywa języka IL .subsystem została określona w pliku, to polecenie zastępuje ją. Aby uzyskać listę prawidłowych wartości dla elementu integer, zobacz winnt.h, IMAGE_SUBSYSTEM .
/x64 Określa 64-bitowy procesor firmy AMD jako procesor docelowy.

Jeśli nie określono bitowości obrazu, wartość domyślna to /pe64.
/? Wyświetla składnię polecenia i opcje narzędzia.

Uwaga

Wszystkie opcje dla Ilasm.exe są bez uwzględniania wielkości liter i rozpoznawane przez pierwsze trzy litery. Na przykład /lis jest odpowiednikiem /listing i /res:myresfile.res jest odpowiednikiem /resource:myresfile.res. Opcje określające argumenty akceptują dwukropek (:) lub znak równości (=) jako separator między opcją a argumentem. Na przykład /output:file.ext jest odpowiednikiem /output=file.ext.

Uwagi

Program IL Assembler umożliwia dostawcom narzędzi projektowanie i implementowanie generatorów języka IL. Korzystając z Ilasm.exe, deweloperzy narzędzi i kompilatora mogą skoncentrować się na generowaniu il i metadanych bez konieczności emitowania IL w formacie pliku PE.

Podobnie jak w przypadku innych kompilatorów przeznaczonych dla środowiska uruchomieniowego, takich jak C# i Visual Basic, Ilasm.exe nie tworzy plików obiektów pośrednich i nie wymaga etapu łączenia w celu utworzenia pliku PE.

Program IL Assembler może wyrazić wszystkie istniejące metadane i funkcje IL języków programowania, które są przeznaczone dla środowiska uruchomieniowego. Dzięki temu kod zarządzany napisany w dowolnym z tych języków programowania może być odpowiednio wyrażony w asemblera IL i skompilowany przy użyciu Ilasm.exe.

Uwaga

Kompilacja może się nie powieść, jeśli ostatni wiersz kodu w pliku źródłowym il nie kończy się znakiem odstępu ani znakiem końca wiersza.

Można użyć Ilasm.exe w połączeniu z jego narzędziem towarzyszącym, Ildasm.exe. Ildasm.exe pobiera plik PE zawierający kod IL i tworzy plik tekstowy odpowiedni jako dane wejściowe do Ilasm.exe. Jest to przydatne na przykład podczas kompilowania kodu w języku programowania, który nie obsługuje wszystkich atrybutów metadanych środowiska uruchomieniowego. Po skompilowaniu kodu i uruchomieniu danych wyjściowych za pośrednictwem Ildasm.exe wynikowy plik tekstowy IL można ręcznie edytować, aby dodać brakujące atrybuty. Następnie możesz uruchomić ten plik tekstowy za pośrednictwem Ilasm.exe w celu utworzenia końcowego pliku wykonywalnego.

Tej techniki można również użyć, aby utworzyć pojedynczy plik PE z kilku plików PE, oryginalnie utworzonych przez różne kompilatory.

Uwaga

Obecnie nie można używać tej techniki w połączeniu z plikami PE zawierającymi osadzony kod natywny (na przykład pliki PE generowane przez program Visual C++).

W celu zapewnienia tego połączonego użycia Ildasm.exe i Ilasm.exe tak dokładne, jak to możliwe, asembler domyślnie nie zastępuje krótkich kodowań długich, które mogły być zapisywane w źródłach IL (lub które mogą być emitowane przez inny kompilator). Użyj /optimize opcji, aby zastąpić krótkie kodowania wszędzie tam, gdzie to możliwe.

Uwaga

Ildasm.exe działa tylko na plikach na dysku. Nie wykonuje operacji na plikach zainstalowanych w globalnej pamięci podręcznej zestawów.

Aby uzyskać więcej informacji na temat gramatyki języka IL, zobacz plik asmparse.grammar w zestawie WINDOWS SDK.

Informacje o wersji

Począwszy od programu .NET Framework 4.5, można dołączyć atrybut niestandardowy do implementacji interfejsu przy użyciu kodu podobnego do następującego:

.class interface public abstract auto ansi IMyInterface
{
  .method public hidebysig newslot abstract virtual
    instance int32 method1() cil managed
  {
  } // end of method IMyInterface::method1
} // end of class IMyInterface
.class public auto ansi beforefieldinit MyClass
  extends [mscorlib]System.Object
  implements IMyInterface
  {
    .interfaceimpl type IMyInterface
    .custom instance void
      [mscorlib]System.Diagnostics.DebuggerNonUserCodeAttribute::.ctor() = ( 01 00 00 00 )
      …

Począwszy od programu .NET Framework 4.5, można określić dowolny obiekt BLOB marshal (duży obiekt binarny) przy użyciu jego nieprzetworzonej reprezentacji binarnej, jak pokazano w poniższym kodzie:

.method public hidebysig abstract virtual
        instance void
        marshal({ 38 01 02 FF })
        Test(object A_1) cil managed

Aby uzyskać więcej informacji na temat gramatyki języka IL, zobacz plik asmparse.grammar w zestawie WINDOWS SDK.

Przykłady

Następujące polecenie tworzy myTestFile.il pliku IL i tworzy myTestFile.exe wykonywalny.

ilasm myTestFile

Następujące polecenie tworzy myTestFile.il pliku IL i tworzy myTestFile.dll pliku .dll.

ilasm myTestFile /dll

Następujące polecenie tworzy myTestFile.il pliku IL i tworzy plik .dll myNewTestFile.dll.

ilasm myTestFile /dll /output:myNewTestFile.dll

Poniższy przykład kodu przedstawia niezwykle prostą aplikację, która wyświetla komunikat "Hello World!" do konsoli. Możesz skompilować ten kod, a następnie użyć narzędzia Ildasm.exe do wygenerowania pliku IL.

using System;

public class Hello
{
    public static void Main(String[] args)
    {
        Console.WriteLine("Hello World!");
    }
}

Poniższy przykład kodu w języku IL odpowiada poprzedniemu przykładowi kodu w języku C#. Ten kod można skompilować do zestawu przy użyciu narzędzia asemblera IL. W konsoli są wyświetlane przykłady kodu IL i C#.

// Metadata version: v2.0.50215
.assembly extern mscorlib
{
  .publickeytoken = (B7 7A 5C 56 19 34 E0 89 )                         // .z\V.4..
  .ver 2:0:0:0
}
.assembly sample
{
  .custom instance void [mscorlib]System.Runtime.CompilerServices.CompilationRelaxationsAttribute::.ctor(int32) = ( 01 00 08 00 00 00 00 00 )
  .hash algorithm 0x00008004
  .ver 0:0:0:0
}
.module sample.exe
// MVID: {A224F460-A049-4A03-9E71-80A36DBBBCD3}
.imagebase 0x00400000
.file alignment 0x00000200
.stackreserve 0x00100000
.subsystem 0x0003       // WINDOWS_CUI
.corflags 0x00000001    //  ILONLY
// Image base: 0x02F20000

// =============== CLASS MEMBERS DECLARATION ===================

.class public auto ansi beforefieldinit Hello
       extends [mscorlib]System.Object
{
  .method public hidebysig static void  Main(string[] args) cil managed
  {
    .entrypoint
    // Code size       13 (0xd)
    .maxstack  8
    IL_0000:  nop
    IL_0001:  ldstr      "Hello World!"
    IL_0006:  call       void [mscorlib]System.Console::WriteLine(string)
    IL_000b:  nop
    IL_000c:  ret
  } // end of method Hello::Main

  .method public hidebysig specialname rtspecialname
          instance void  .ctor() cil managed
  {
    // Code size       7 (0x7)
    .maxstack  8
    IL_0000:  ldarg.0
    IL_0001:  call       instance void [mscorlib]System.Object::.ctor()
    IL_0006:  ret
  } // end of method Hello::.ctor

} // end of class Hello

Zobacz też