Ildasm.exe (IL Ayrıştırıcı)

IL Disassembler, IL Assembler'a (Ilasm.exe) yardımcı bir araçtır. Ildasm.exe, ara dil (IL) kodu içeren taşınabilir bir yürütülebilir (PE) dosyası alır ve Ilasm.exe giriş olarak uygun bir metin dosyası oluşturur.

Bu araç, Visual Studio ile birlikte otomatik olarak yüklenir. Aracı çalıştırmak için Visual Studio Geliştirici Komut İstemi'ni veya Visual Studio Geliştirici PowerShell'i kullanın.

Komut istemine şunu yazın:

Sözdizimi

ildasm [options] [PEfilename] [options]

Parametreler

.exe, .dll, .obj, .lib ve .winmd dosyaları için aşağıdaki seçenekler kullanılabilir.

.exe, .dll ve .winmd dosyaları için aşağıdaki ek seçenekler kullanılabilir.

Aşağıdaki seçenekler yalnızca dosya veya konsol çıkışı için .exe, .dll ve .winmd dosyaları için geçerlidir.

Aşağıdaki seçenekler yalnızca dosya veya konsol çıkışı için .exe, .dll, .obj, .lib ve .winmd dosyaları için geçerlidir.

Aşağıdaki seçenekler yalnızca dosya veya konsol çıkışı için .lib dosyaları için geçerlidir.

Açıklamalar

Ildasm.exe yalnızca disk üzerindeki PE dosyalarında çalışır. Genel bütünleştirilmiş kod önbelleğine yüklü olan dosyalar üzerinde çalışmaz.

Ildasm.exe tarafından üretilen metin dosyası, IL Assembler'a (Ilasm.exe) giriş olarak kullanılabilir. Bu örneğin, tüm çalışma zamanı meta veri özniteliklerini desteklemeyen bir programlama dilinde kod derlerken kullanışlıdır. Kodu derleyip çıktısını Ildasm.exe çalıştırdıktan sonra, sonuçta elde edilen IL metin dosyası eksik öznitelikleri eklemek için el ile düzenlenebilir. Ardından bu metin dosyasını IL Derleyicisi aracılığıyla çalıştırarak son bir çalıştırılabilir dosya oluşturabilirsiniz.

Meta veriyi ve varolan herhangi bir PE dosyasının ayrıştırılmış kodunu hiyerarşik bir ağaç görünümünde görüntülemek için varsayılan GUI'yi IL Ayrıştırıcısı'nda kullanabilirsiniz. GUI'yi kullanmak için PEfilename bağımsız değişkenini veya herhangi bir seçeneği belirtmeden komut satırına ildasm yazın. Dosya menüsünden, Ildasm.exe yüklemek istediğiniz PE dosyasına gidebilirsiniz. Seçili PE için görüntülenen meta verileri ve ayrıştırılmış kodu kaydetmek için Dosya menüsünden Döküm komutunu seçin. Yalnızca hiyerarşik ağaç görünümünü kaydetmek için Dosya menüsünden Dump Treeview komutunu seçin. Bir dosyayı Ildasm.exe yükleme ve çıkışı yorumlama hakkında ayrıntılı bir kılavuz için Windows SDK ile birlikte gelen Örnekler klasöründe bulunan Ildasm.exe Öğreticisi'ne bakın.

Ildasm.exe katıştırılmış kaynaklar içeren bir PEfilename bağımsız değişkeni sağlarsanız, araç birden çok çıkış dosyası oluşturur: IL kodunu içeren bir metin dosyası ve eklenen her yönetilen kaynak için meta verilerden kaynağın adı kullanılarak oluşturulan bir .resources dosyası. Yönetilmeyen bir kaynak PEfilename içine eklenmişse, /output seçeneği tarafından IL çıktısı için belirtilen dosya adı kullanılarak bir .res dosyası oluşturulur.

Ildasm.exe an.exe veya .dll dosyası üzerinden çalıştırarak dosyanın yönetilip yönetilmediğini belirleyebilirsiniz. Dosya yönetilmiyorsa; araç, dosyada geçerli hiçbir ortak dil çalışma zamanı başlığı olmadığını ve ayrıştırılamayacağını belirten bir ileti görüntüler. Dosya yönetiliyorsa, araç başarıyla çalışır.

Sürüm Bilgisi

.NET Framework 4.5'den başlayarak, Ildasm.exe ham ikili içeriği görüntüleyerek tanınmayan bir sıralama BLOB'unu (ikili büyük nesne) işler. Örneğin aşağıdaki kod, bir C# programı tarafından oluşturulmuş sıralama BLOB'unun nasıl görüntülendiğini gösterir:

public void Test([MarshalAs((short)70)] int test) { }

// IL from Ildasm.exe output
.method public hidebysig instance void Test(int32  marshal({ 46 }) test) cil managed

.NET Framework 4.5'ten başlayarak Ildasm.exe, Ildasm.exe çıktıdan aşağıdaki alıntıda gösterildiği gibi arabirim uygulamalarına uygulanan öznitelikleri görüntüler:

.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 )
      …

Örnekler

Aşağıdaki komut, PE dosyasının MyHello.exe meta verilerinin ve ayrıştırılmış kodun Ildasm.exe varsayılan GUI'de görüntülenmesine neden olur.

ildasm myHello.exe

Aşağıdaki komut dosyayı MyFile.exe ayrıştırarak elde edilen IL Assembler metnini dosya MyFile.il depolar.

ildasm MyFile.exe /output:MyFile.il

Aşağıdaki komut dosyayı MyFile.exe ayrıştırarak sonuçta elde edilen IL Assembler metnini konsol penceresine görüntüler.

ildasm MyFile.exe /text

Dosya MyApp.exe eklenmiş yönetilen ve yönetilmeyen kaynaklar içeriyorsa, aşağıdaki komut dört dosya oluşturur: MyApp.il, MyApp.res, Icons.resources ve Message.resources:

ildasm MyApp.exe /output:MyApp.il

Aşağıdaki komut, içindeki sınıfı MyClass MyFile.exe içindeki yöntemini MyMethod ayrıştırır ve çıkışı konsol penceresine görüntüler.

ildasm /item:MyClass::MyMethod MyFile.exe /text

Önceki örnekte, farklı imzalara sahip adlı MyMethod birkaç yöntem olabilir. Aşağıdaki komut, dönüş türü void ve int32 ve dize parametre türleriyle örnek yöntemini MyMethod parçalara ayırır.

ildasm /item:"MyClass::MyMethod(instance void(int32,string)" MyFile.exe /text

Bir static yöntemi (Shared Visual Basic'te yöntemi) almak için anahtar sözcüğünü instanceatla. gibi int32 ilkel türler olmayan sınıf string türleri ad alanını içermelidir ve önce anahtar sözcüğünü classiçermelidir. Dış türlerin başına köşeli ayraçlar içinde kitaplık adı gelmelidir. Aşağıdaki komut, türünde bir parametresi olan ve dönüş türüne AppDomain AppDomainsahip olan adlı MyMethod statik yöntemi parçalara ayırır.

ildasm /item:"MyClass::MyMethod(class [mscorlib]System.AppDomain(class [mscorlib]System.AppDomain)" MyFile.exe /text

İç içe geçmiş bir türün başında, eğik çizgi ile sınırlandırılmış kapsayan sınıfı bulunmalıdır. Örneğin, MyNamespace.MyClass sınıfı adlı NestedClassiç içe geçmiş bir sınıf içeriyorsa, iç içe geçmiş sınıf şu şekilde tanımlanır: class MyNamespace.MyClass/NestedClass.

Ayrıca bkz.

• Araçlar
• Ilasm.exe (IL Derleyici)
• Yönetilen Yürütme İşlemi
• Geliştirici komut satırı kabukları