Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Mengambil daftar satu atau beberapa nama pustaka jenis atau file .tlb dan menyelesaikan pustaka jenis tersebut ke lokasi pada disk.
Parameters
Tabel berikut ini menjelaskan parameter tugas ResolveCOMReference.
| Parameter | Description |
|---|---|
DelaySign |
Parameter Boolean opsional.Jika true, tempatkan kunci publik di rakitan. Jika false, sepenuhnya menandatangani rakitan. |
EnvironmentVariables |
Parameter String[] opsional.Array pasangan variabel lingkungan, dipisahkan oleh tanda yang sama. Variabel ini diteruskan ke tlbimp.exe dan aximp.exe yang ditelurkan selain, atau ditimpa secara selektif, blok lingkungan reguler. |
ExecuteAsTool |
Parameter Boolean opsional.Jika true, berjalan tlbimp.exe dan aximp.exe dari kerangka kerja target yang sesuai di luar proc untuk menghasilkan rakitan pembungkus yang diperlukan. Parameter ini memungkinkan multi-penargetan. |
IncludeVersionInInteropName |
Parameter Boolean opsional.Jika true, versi pustaka jenis disertakan dalam nama pembungkus. Defaultnya adalah false. |
KeyContainer |
Parameter String opsional.Menentukan kontainer yang menyimpan pasangan kunci publik/privat. |
KeyFile |
Parameter String opsional.Menentukan item yang berisi pasangan kunci publik/privat. |
NoClassMembers |
Parameter Boolean opsional. |
ResolvedAssemblyReferences |
Parameter output ITaskItem[] opsional.Menentukan referensi rakitan yang diselesaikan. |
ResolvedFiles |
Parameter output ITaskItem[] opsional.Menentukan file yang sepenuhnya memenuhi syarat pada disk yang sesuai dengan lokasi fisik pustaka jenis yang disediakan sebagai input untuk tugas ini. |
ResolvedModules |
Parameter opsional ITaskItem[]. |
SdkToolsPath |
Parameter System.String opsional. Jika ExecuteAsTool adalah true, parameter ini harus diatur ke jalur alat SDK untuk versi kerangka kerja yang ditargetkan. |
StateFile |
Parameter String opsional.Menentukan file cache untuk tanda waktu komponen COM. Jika tidak ada, setiap eksekusi meregenerasi semua pembungkus. |
TargetFrameworkVersion |
Parameter String opsional.Menentukan versi kerangka kerja target proyek. Defaultnya adalah String.Empty. yang berarti tidak ada pemfilteran untuk referensi berdasarkan kerangka kerja target. |
TargetProcessorArchitecture |
Parameter String opsional.Menentukan arsitektur prosesor target yang disukai. Diteruskan ke bendera tlbimp.exe/machine setelah terjemahan. Nilai parameter harus menjadi anggota ProcessorArchitecture. |
TypeLibFiles |
Parameter ITaskItem[] opsional.Menentukan jalur file pustaka jenis ke referensi COM. Item yang disertakan dalam parameter ini mungkin berisi metadata item. Untuk informasi selengkapnya, lihat bagian Metadata item TypeLibFiles. |
TypeLibNames |
Parameter ITaskItem[] opsional.Menentukan nama pustaka tipe yang akan diatasi. Item yang disertakan dalam parameter ini harus berisi beberapa metadata item. Untuk informasi selengkapnya, lihat bagian Metadata item TypeLibNames. |
WrapperOutputDirectory |
Parameter String opsional.Lokasi pada disk tempat perakitan interop yang dihasilkan ditempatkan. Jika metadata item ini tidak ditentukan, tugas menggunakan jalur absolut direktori tempat file proyek berada. |
Metadata item TypeLibNames
Tabel berikut ini menjelaskan metadata item yang tersedia untuk item yang diteruskan ke TypeLibNames parameter .
| Metadata | Description |
|---|---|
GUID |
Metadata item yang diperlukan. GUID untuk pustaka jenis. Jika metadata item ini tidak ditentukan, tugas gagal. |
VersionMajor |
Metadata item yang diperlukan. Versi utama pustaka jenis. Jika metadata item ini tidak ditentukan, tugas gagal. |
VersionMinor |
Metadata item yang diperlukan. Versi minor dari pustaka jenis. Jika metadata item ini tidak ditentukan, tugas gagal. |
EmbedInteropTypes |
Metadata opsional Boolean .Jika true, sematkan jenis interop dari referensi ini langsung ke perakitan Anda daripada menghasilkan DLL interop. |
LocaleIdentifier |
Metadata item opsional. Pengidentifikasi Lokal (atau LCID) untuk pustaka jenis. Pengidentifikasi ini ditentukan sebagai nilai 32-bit yang mengidentifikasi bahasa manusia yang disukai oleh pengguna, wilayah, atau aplikasi. Jika metadata item ini tidak ditentukan, tugas menggunakan pengidentifikasi lokal default "0." |
WrapperTool |
Metadata item opsional. Menentukan alat pembungkus yang digunakan untuk menghasilkan pembungkus rakitan untuk pustaka jenis ini. Jika metadata item ini tidak ditentukan, tugas menggunakan alat pembungkus default "tlbimp." Pilihan pustaka jenis yang tersedia dan tidak peka huruf besar/kecil adalah: - Primary: Gunakan alat pembungkus ini ketika Anda ingin menggunakan perakitan interop utama yang sudah dihasilkan untuk komponen COM. Ketika Anda menggunakan alat pembungkus ini, jangan tentukan direktori output pembungkus karena itu menyebabkan tugas gagal.- TLBImp: Gunakan alat pembungkus ini saat Anda ingin menghasilkan perakitan interop untuk komponen COM.- PrimaryOrTLBImp: Gunakan alat pembungkus ini ketika Anda tidak yakin apakah Primary atau TLBImp sesuai. Logika Primary diterapkan terlebih dahulu, lalu TLBImp.- AXImp: Gunakan alat pembungkus ini saat Anda ingin membuat perakitan interop untuk Kontrol ActiveX. |
Metadata item TypeLibFiles
Tabel berikut ini menjelaskan metadata item yang tersedia untuk item yang diteruskan ke TypeLibFiles parameter .
| Metadata | Description |
|---|---|
EmbedInteropTypes |
Parameter Boolean opsional.Jika true, sematkan jenis interop dari referensi ini langsung ke perakitan Anda daripada menghasilkan DLL interop. |
WrapperTool |
Metadata item opsional. Menentukan alat pembungkus yang digunakan untuk menghasilkan pembungkus rakitan untuk pustaka jenis ini. Jika metadata item ini tidak ditentukan, tugas menggunakan alat pembungkus default "tlbimp." Pilihan pustaka jenis yang tersedia dan tidak peka huruf besar/kecil adalah: - Primary: Gunakan alat pembungkus ini ketika Anda ingin menggunakan perakitan interop utama yang sudah dihasilkan untuk komponen COM. Ketika Anda menggunakan alat pembungkus ini, jangan tentukan direktori output pembungkus karena itu menyebabkan tugas gagal.- TLBImp: Gunakan alat pembungkus ini saat Anda ingin menghasilkan perakitan interop untuk komponen COM.- AXImp: Gunakan alat pembungkus ini saat Anda ingin membuat perakitan interop untuk Kontrol ActiveX. |
Note
Semakin banyak informasi yang Anda berikan untuk mengidentifikasi pustaka jenis secara unik, semakin besar kemungkinan tugas diselesaikan ke file yang benar pada disk.
Remarks
Selain parameter yang tercantum dalam artikel ini, tugas ini mewarisi parameter dari Task kelas . Untuk daftar parameter tambahan ini dan deskripsinya, lihat kelas dasar Tugas.
COM DLL tidak perlu didaftarkan pada komputer agar tugas ini berfungsi.
MSB4803 Error
Jika Anda mencoba menjalankan proyek yang menggunakan ResolveCOMReference tugas dari dotnet perintah CLI, Anda mendapatkan kesalahan:
MSB4803: The task "ResolveComReference" is not supported on the .NET Core version of MSBuild. Please use the .NET Framework version of MSBuild.
Tugas ini tidak didukung pada MSBuild versi .NET Core, yang merupakan apa yang digunakan saat Anda menjalankan dotnet build perintah dari baris perintah. Coba buat proyek dengan memanggil MSBuild.exe dari Prompt Perintah Pengembang Visual Studio, karena executable ini menggunakan MSBuild versi .NET Framework.