ResolveComReference görevi

Makale
10/13/2023

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	Tanım
`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'ye 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ışında 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 `ExecuteAsTooltrue`, 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/machine 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	Tanım
`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 Tanım

EmbedInteropTypes İsteğe bağlı Booleanparametre.

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.

Meta veri	Tanım
`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.

Dekont

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. MsBuild.exe dosyasını Visual Studio Geliştirici Komut İstemi'nden çağırarak projeyi oluşturmayı deneyin çünkü bu, MSBuild'in .NET Framework sürümünü kullanır.