ResolveComReference görevi
Bir veya daha fazla tür kitaplığı adının veya .tlb dosyasının listesini alır ve bu tür kitaplıkları disk üzerindeki konumlara çözümler.
Parametreler
Aşağıdaki tabloda görevin parametreleri ResolveCOMReference açıklanmaktadır.
| Parametre | Açıklama |
|---|---|
DelaySign |
İsteğe bağlı Boolean parametre.ise true, ortak anahtarı derlemeye yerleştirir. ise false, derlemeyi tamamen imzalar. |
EnvironmentVariables |
İsteğe bağlı String[] parametre.Eşit işaretlerle ayrılmış ortam değişkenleri çiftleri dizisi. Bu değişkenler, normal ortam bloğuna ek olarak veya seçmeli olarak geçersiz kılmaya ek olarak oluşturulan tlbimp.exe ve aximp.exe geçirilir.. |
ExecuteAsTool |
İsteğe bağlı Boolean parametre.ise true, gerekli sarmalayıcı derlemelerini oluşturmak için uygun hedef çerçeveden proc dışından tlbimp.exe ve aximp.exe çalıştırır. Bu parametre çoklu hedeflemeyi etkinleştirir. |
IncludeVersionInInteropName |
İsteğe bağlı Boolean parametre.ise true, typelib sürümü sarmalayıcı adına eklenir. Varsayılan değer: false. |
KeyContainer |
İsteğe bağlı String parametre.Ortak/özel anahtar çifti tutan bir kapsayıcı belirtir. |
KeyFile |
İsteğe bağlı String parametre.Ortak/özel anahtar çifti içeren bir öğeyi belirtir. |
NoClassMembers |
İsteğe bağlı Boolean parametre. |
ResolvedAssemblyReferences |
İsteğe bağlı ITaskItem[] çıkış parametresi.Çözümlenen derleme başvurularını belirtir. |
ResolvedFiles |
İsteğe bağlı ITaskItem[] çıkış parametresi.Diskte, bu göreve giriş olarak sağlanan tür kitaplıklarının fiziksel konumlarına karşılık gelen tam dosyaları belirtir. |
ResolvedModules |
İsteğe bağlı ITaskItem[]parametre. |
SdkToolsPath |
İsteğe bağlı System.String parametre. ise ExecuteAsTool true, bu parametre hedeflenen çerçeve sürümü için SDK araçları yoluna ayarlanmalıdır. |
StateFile |
İsteğe bağlı String parametre.COM bileşeni zaman damgaları için önbellek dosyasını belirtir. Yoksa, her çalıştırma tüm sarmalayıcıları yeniden oluşturur. |
TargetFrameworkVersion |
İsteğe bağlı String parametre.Proje hedef çerçeve sürümünü belirtir. Varsayılan değer: String.Empty. bu, hedef çerçeveyi temel alan bir başvuru için filtreleme olmadığı anlamına gelir. |
TargetProcessorArchitecture |
İsteğe bağlı String parametre.Tercih edilen hedef işlemci mimarisini belirtir. Çeviriden sonra tlbimp.exe/makine bayrağına geçirildi. Parametre değeri öğesinin ProcessorArchitectureüyesi olmalıdır. |
TypeLibFiles |
İsteğe bağlı ITaskItem[] parametre.COM başvurularının tür kitaplığı dosya yolunu belirtir. Bu parametreye dahil edilen öğeler öğe meta verileri içerebilir. Daha fazla bilgi için aşağıdaki TypeLibFiles öğe meta verileri bölümüne bakın. |
TypeLibNames |
İsteğe bağlı ITaskItem[] parametre.Çözümlenmesi gereken tür kitaplığı adlarını belirtir. Bu parametreye dahil edilen öğeler bazı öğe meta verileri içermelidir. Daha fazla bilgi için aşağıdaki TypeLibNames öğe meta verileri bölümüne bakın. |
WrapperOutputDirectory |
İsteğe bağlı String parametre.Oluşturulan birlikte çalışma derlemesinin yerleştirildiği disk konumu. Bu öğe meta verileri belirtilmezse, görev proje dosyasının bulunduğu dizinin mutlak yolunu kullanır. |
TypeLibNames öğe meta verileri
Aşağıdaki tabloda, parametresine geçirilen TypeLibNames öğeler için kullanılabilen öğe meta verileri açıklanmaktadır.
| Meta veri | Açıklama |
|---|---|
GUID |
Gerekli öğe meta verileri. Tür kitaplığı için GUID. Bu öğe meta verileri belirtilmezse görev başarısız olur. |
VersionMajor |
Gerekli öğe meta verileri. Tür kitaplığının ana sürümü. Bu öğe meta verileri belirtilmezse görev başarısız olur. |
VersionMinor |
Gerekli öğe meta verileri. Tür kitaplığının ikincil sürümü. Bu öğe meta verileri belirtilmezse görev başarısız olur. |
EmbedInteropTypes |
İsteğe bağlı Boolean meta veriler.ise true, birlikte çalışma DLL'sini oluşturmak yerine bu başvurudaki birlikte çalışma türlerini doğrudan derlemenize ekleyin. |
LocaleIdentifier |
İsteğe bağlı öğe meta verileri. Tür kitaplığı için Yerel Ayar Tanımlayıcısı (veya LCID). Bu, bir kullanıcı, bölge veya uygulama tarafından tercih edilen insan dilini tanımlayan 32 bitlik bir değer olarak belirtilir. Bu öğe meta verileri belirtilmezse, görev "0" varsayılan yerel ayar tanımlayıcısını kullanır. |
WrapperTool |
İsteğe bağlı öğe meta verileri. Bu tür kitaplığı için derleme sarmalayıcısını oluşturmak için kullanılan sarmalayıcı aracını belirtir. Bu öğe meta verileri belirtilmezse, görev "tlbimp" varsayılan sarmalayıcı aracını kullanır. Kullanılabilir büyük/küçük harfe duyarsız tür türleri şunlardır: - Primary: COM bileşeni için önceden oluşturulmuş bir birincil birlikte çalışma derlemesi kullanmak istediğinizde bu sarmalayıcı aracını kullanın. Bu sarmalayıcı aracını kullandığınızda, görevin başarısız olmasına neden olacağı için bir sarmalayıcı çıkış dizini belirtmeyin.- TLBImp: COM bileşeni için birlikte çalışma derlemesi oluşturmak istediğinizde bu sarmalayıcı aracını kullanın.- PrimaryOrTLBImp: Uygun olup TLBImp olmadığından emin değilseniz Primary bu sarmalayıcı aracını kullanın. Mantık Primary önce uygulanır, ardından TLBImp.- AXImp:ActiveX Denetimi için birlikte çalışma derlemesi oluşturmak istediğinizde bu sarmalayıcı aracını kullanın. |
TypeLibFiles öğe meta verileri
Aşağıdaki tabloda, parametresine geçirilen TypeLibFiles öğeler için kullanılabilen öğe meta verileri açıklanmaktadır.
| Meta veri | Açıklama |
|---|---|
EmbedInteropTypes |
İsteğe bağlı Boolean parametre.ise true, birlikte çalışma DLL'sini oluşturmak yerine bu başvurudaki birlikte çalışma türlerini doğrudan derlemenize ekleyin. |
WrapperTool |
İsteğe bağlı öğe meta verileri. Bu tür kitaplığı için derleme sarmalayıcısını oluşturmak için kullanılan sarmalayıcı aracını belirtir. Bu öğe meta verileri belirtilmezse, görev "tlbimp" varsayılan sarmalayıcı aracını kullanır. Kullanılabilir büyük/küçük harfe duyarsız tür türleri şunlardır: - Primary: COM bileşeni için önceden oluşturulmuş bir birincil birlikte çalışma derlemesi kullanmak istediğinizde bu sarmalayıcı aracını kullanın. Bu sarmalayıcı aracını kullandığınızda, görevin başarısız olmasına neden olacağı için bir sarmalayıcı çıkış dizini belirtmeyin.- TLBImp: COM bileşeni için birlikte çalışma derlemesi oluşturmak istediğinizde bu sarmalayıcı aracını kullanın.- AXImp: ActiveX Denetimi için birlikte çalışma derlemesi oluşturmak istediğinizde bu sarmalayıcı aracını kullanın. |
Not
Bir tür kitaplığını benzersiz olarak tanımlamak için ne kadar fazla bilgi sağlarsanız, görevin diskte doğru dosyaya çözümlenmesi olasılığı o kadar artar.
Açıklamalar
Yukarıda listelenen parametrelere ek olarak, bu görev parametreleri sınıfından Task devralır. Bu ek parametrelerin ve açıklamalarının listesi için bkz . Görev temel sınıfı.
Bu görevin çalışması için COM DLL'sinin makineye kaydedilmesi gerekmez.
MSB4803 Hatası
CLI komutlarından görevi kullanan ResolveCOMReference bir proje çalıştırmaya dotnet çalışırsanız şu hatayı alırsınız:
MSB4803: The task "ResolveComReference" is not supported on the .NET Core version of MSBuild. Please use the .NET Framework version of MSBuild.
Bu görev, komutu komut satırından çalıştırdığınızda dotnet build kullanılan MSBuild'in .NET Core sürümünde desteklenmez. Bu işlem MSBuild'in .NET Framework sürümünü kullandığından Visual Studio Geliştirici Komut İstemi'nden MSBuild.exe çağırarak projeyi oluşturmayı deneyin.