Bagikan melalui

Winmdexp.exe (Alat Ekspor Metadata Runtime Windows)

Alat Ekspor Metadata Runtime Windows (Winmdexp.exe) mengubah modul .NET Framework menjadi file yang berisi metadata Windows Runtime. Meskipun rakitan .NET Framework dan file metadata Windows Runtime menggunakan format fisik yang sama, ada perbedaan dalam konten tabel metadata, yang berarti bahwa rakitan .NET Framework tidak secara otomatis dapat digunakan sebagai Komponen Runtime Windows. Proses mengubah modul .NET Framework menjadi komponen Windows Runtime disebut sebagai ekspor. Dalam file .NET Framework 4.5 dan 4.5.1, file metadata Windows (.winmd) yang dihasilkan berisi metadata dan implementasi.

Saat Anda menggunakan templat Komponen Runtime Windows , yang terletak di bawah Windows Store untuk C# dan Visual Basic di Visual Studio 2013 atau Visual Studio 2012, target pengkompilasi adalah file .winmdobj, dan langkah build berikutnya memanggil Winmdexp.exe untuk mengekspor file .winmdobj ke file .winmd. Ini adalah cara yang disarankan untuk membangun komponen Windows Runtime. Gunakan Winmdexp.exe secara langsung saat Anda menginginkan kontrol lebih besar atas proses build daripada yang disediakan Visual Studio.

Alat ini otomatis terpasang dengan Visual Studio. Untuk menjalankan alat ini, gunakan Perintah Pengembang Visual Studio atau Visual Studio Developer PowerShell.

Pada perintah, masukkan berikut ini:

Sintaksis

winmdexp [options] winmdmodule

Parameter-parameternya

Argumen atau opsi Deskripsi
winmdmodule Menentukan modul (.winmdobj) yang akan diekspor. Hanya satu modul yang diizinkan. Untuk membuat modul ini, gunakan /target opsi pengkompilasi dengan winmdobj target. Lihat -target:winmdobj (C# Compiler Options) atau -target (Visual Basic).
/docfile: docfile

/d: docfile 		Menentukan file dokumentasi XML output yang akan dihasilkan Winmdexp.exe. Dalam .NET Framework 4.5, file output pada dasarnya sama dengan file dokumentasi XML input.
/moduledoc: docfile

/md: docfile 		Menentukan nama file dokumentasi XML yang dihasilkan pengkompilasi dengan winmdmodule.
/modulepdb: symbolfile

/mp: symbolfile 		Menentukan nama file database program (PDB) yang berisi simbol untuk winmdmodule.
/nowarn: warning Menekan nomor peringatan yang ditentukan. Untuk peringatan, hanya berikan bagian numerik dari kode kesalahan, tanpa diawali nol.
/out: file

/o: file 		Menentukan nama file metadata Windows output (.winmd).
/pdb: symbolfile

/p: symbolfile 		Menentukan nama file database program output (PDB) yang akan berisi simbol untuk file metadata Windows (.winmd) yang diekspor.
/reference: winmd

/r: winmd 		Menentukan file metadata (.winmd atau assembly) untuk dirujuk selama ekspor. Jika Anda menggunakan rakitan referensi di "\Program Files (x86)\Reference Assemblies\Microsoft\Framework\. NETCore\v4.5" ("\Program Files\..." pada komputer 32-bit), sertakan referensi ke System.Runtime.dll dan mscorlib.dll.
/utf8output Menentukan bahwa pesan output harus dalam pengodean UTF-8.
/warnaserror+ Menentukan bahwa semua peringatan harus diperlakukan sebagai kesalahan.
@ responsefile Menentukan file respons (.rsp) yang berisi opsi (dan opsional winmdmodule). Setiap baris di responsefile harus berisi satu argumen atau opsi.

Komentar

Winmdexp.exe tidak dirancang untuk mengonversi rakitan .NET Framework sewenang-wenang menjadi file .winmd. Ini memerlukan modul yang dikompilasi dengan /target:winmdobj opsi , dan pembatasan tambahan berlaku. Yang paling penting dari pembatasan ini adalah bahwa semua jenis yang terekspos di permukaan API assembly harus jenis Windows Runtime. Untuk informasi selengkapnya, lihat bagian "Mendeklarasikan jenis di Komponen Runtime Windows" dari artikel Membuat Komponen Runtime Windows di C# dan Visual Basic.

Saat Anda menulis aplikasi Windows 8.x Store atau komponen Windows Runtime dengan C# atau Visual Basic, .NET Framework menyediakan dukungan untuk membuat pemrograman dengan Windows Runtime lebih alami. Ini dibahas dalam artikel Dukungan .NET Framework untuk Aplikasi Windows Store dan Windows Runtime. Dalam prosesnya, beberapa jenis Windows Runtime yang umum digunakan dipetakan ke jenis .NET Framework. Winmdexp.exe membalikkan proses ini dan menghasilkan permukaan API yang menggunakan jenis Windows Runtime yang sesuai. Misalnya, jenis yang dibangun dari IList<T> peta antarmuka ke jenis yang dibangun dari antarmuka Windows Runtime IVector<T> .

Lihat juga

  • Last updated on