Tugas ResolveComReference

Artikel
06/19/2023

Mengambil daftar satu atau beberapa nama pustaka jenis atau file .tlb dan menyelesaikan pustaka jenis tersebut ke lokasi pada disk.

Parameter

Tabel berikut ini menjelaskan parameter tugas ResolveCOMReference.

Parameter	Deskripsi
`DelaySign`	Parameter `Boolean` opsional. Jika `true`, tempatkan kunci publik di rakitan. Jika `false`, sepenuhnya menandatangani assembly.
`EnvironmentVariables`	Parameter `String[]` opsional. Array pasangan variabel lingkungan, dipisahkan oleh tanda sama dengan. Variabel ini diteruskan ke tlbimp.exe yang diluaskan dan aximp.exe 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 multipenargetan.
`IncludeVersionInInteropName`	Parameter `Boolean` opsional. Jika `true`, versi typelib akan disertakan dalam nama pembungkus. Default 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 ITaskItem`[]` opsional.
`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 stempel waktu komponen COM. Jika tidak ada, setiap eksekusi akan membuat ulang semua pembungkus.
`TargetFrameworkVersion`	Parameter `String` opsional. Menentukan versi kerangka kerja target proyek. Default adalah `String.Empty`. yang berarti tidak ada pemfilteran untuk referensi berdasarkan kerangka kerja target.
`TargetProcessorArchitecture`	Parameter `String` opsional. Menentukan arsitektur prosesor target yang dipilih. 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 mengetahui informasi selengkapnya, lihat bagian Metadata item TypeLibFiles di bawah ini.
`TypeLibNames`	Parameter ITaskItem`[]` opsional. Menentukan nama pustaka jenis yang akan diatasi. Item yang disertakan dalam parameter ini harus berisi beberapa metadata item. Untuk mengetahui informasi selengkapnya, lihat bagian Metadata item TypeLibNames di bawah ini.
`WrapperOutputDirectory`	Parameter `String` opsional. Lokasi pada disk tempat rakitan interop yang dibuat 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 parameter TypeLibNames.

Metadata	Deskripsi
`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 `Boolean` opsional. Jika `true`, sematkan jenis interop dari referensi ini langsung ke rakitan Anda daripada membuat DLL interop.
`LocaleIdentifier`	Metadata item opsional. Pengidentifikasi Lokal (atau LCID) untuk pustaka jenis. 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 membuat pembungkus rakitan untuk pustaka jenis ini. Jika metadata item ini tidak ditentukan, tugas menggunakan alat pembungkus default "tlbimp". Pilihan typelibs yang tersedia dan tidak peka huruf besar/kecil adalah: - `Primary`: Gunakan alat pembungkus ini saat Anda ingin menggunakan rakitan interop utama yang sudah dibuat untuk komponen COM. Saat Anda menggunakan alat pembungkus ini, jangan tentukan direktori output pembungkus karena ini akan menyebabkan tugas gagal. - `TLBImp`: Gunakan alat pembungkus ini saat Anda ingin membuat rakitan interop untuk komponen COM. - `PrimaryOrTLBImp`: Gunakan alat pembungkus ini saat Anda tidak yakin apakah `Primary` atau `TLBImp` sesuai. Logika `Primary` diterapkan terlebih dahulu, lalu `TLBImp`. - `AXImp`: Gunakan alat pembungkus ini saat Anda ingin membuat rakitan interop untuk Kontrol ActiveX.

Metadata item TypeLibFiles

Tabel berikut ini menjelaskan metadata item yang tersedia untuk item yang diteruskan ke parameter TypeLibFiles.

Metadata Deskripsi

EmbedInteropTypes Parameter Boolean opsional.

Jika true, sematkan jenis interop dari referensi ini langsung ke rakitan Anda daripada membuat DLL interop.

WrapperTool Metadata item opsional.

Menentukan alat pembungkus yang digunakan untuk membuat pembungkus rakitan untuk pustaka jenis ini. Jika metadata item ini tidak ditentukan, tugas menggunakan alat pembungkus default "tlbimp". Pilihan typelibs yang tersedia dan tidak peka huruf besar/kecil adalah:

- Primary: Gunakan alat pembungkus ini saat Anda ingin menggunakan rakitan interop utama yang sudah dibuat untuk komponen COM. Saat Anda menggunakan alat pembungkus ini, jangan tentukan direktori output pembungkus karena ini akan menyebabkan tugas gagal.
- TLBImp: Gunakan alat pembungkus ini saat Anda ingin membuat rakitan interop untuk komponen COM.
- AXImp: Gunakan alat pembungkus ini saat Anda ingin membuat rakitan interop untuk Kontrol ActiveX.

Metadata	Deskripsi
`EmbedInteropTypes`	Parameter `Boolean` opsional. Jika `true`, sematkan jenis interop dari referensi ini langsung ke rakitan Anda daripada membuat DLL interop.
`WrapperTool`	Metadata item opsional. Menentukan alat pembungkus yang digunakan untuk membuat pembungkus rakitan untuk pustaka jenis ini. Jika metadata item ini tidak ditentukan, tugas menggunakan alat pembungkus default "tlbimp". Pilihan typelibs yang tersedia dan tidak peka huruf besar/kecil adalah: - `Primary`: Gunakan alat pembungkus ini saat Anda ingin menggunakan rakitan interop utama yang sudah dibuat untuk komponen COM. Saat Anda menggunakan alat pembungkus ini, jangan tentukan direktori output pembungkus karena ini akan menyebabkan tugas gagal. - `TLBImp`: Gunakan alat pembungkus ini saat Anda ingin membuat rakitan interop untuk komponen COM. - `AXImp`: Gunakan alat pembungkus ini saat Anda ingin membuat rakitan interop untuk Kontrol ActiveX.

Catatan

Semakin banyak informasi yang Anda berikan untuk mengidentifikasi pustaka jenis secara unik, semakin besar kemungkinan tugas akan diselesaikan ke file yang benar pada disk.

Keterangan

Selain parameter yang tercantum di atas, tugas ini mewarisi parameter dari kelas Task. Untuk daftar parameter tambahan tersebut dan deskripsinya, lihat Kelas dasar tugas.

COM DLL tidak perlu didaftarkan pada komputer agar tugas ini berfungsi.

Kesalahan MSB4803

Jika Anda mencoba menjalankan proyek yang menggunakan tugas ResolveCOMReference dari perintah CLI dotnet, 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 digunakan saat Anda menjalankan perintah dotnet build dari baris perintah. Coba buat proyek dengan memanggil MSBuild.exe dari Perintah Pengembang Visual Studio, karena ini menggunakan versi .NET Framework MSBuild.

Bagikan melalui