Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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.
Parameters
Aşağıdaki tabloda ResolveCOMReference görevinin parametreleri açıklanmaktadır.
| Parameter | Description |
|---|---|
DelaySign |
İsteğe bağlı Boolean parametresi.ise true, ortak anahtarı derlemeye yerleştirir. ise false, derlemeyi tamamen imzalar. |
EnvironmentVariables |
İsteğe bağlı String[] parametresi.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 parametresi.true, gerekli sarmalayıcı derlemelerini oluşturmak için uygun hedef çerçeveden tlbimp.exe ve aximp.exe çalıştırır. Bu parametre çoklu hedeflemeyi etkinleştirir. |
IncludeVersionInInteropName |
İsteğe bağlı Boolean parametresi.ise true, tür kitaplığı sürümü sarmalayıcı adına eklenir. Varsayılan değer: false. |
KeyContainer |
İsteğe bağlı String parametresi.Ortak/özel anahtar çifti tutan bir kapsayıcı belirtir. |
KeyFile |
İsteğe bağlı String parametresi.Ortak/özel anahtar çifti içeren bir öğeyi belirtir. |
NoClassMembers |
İsteğe bağlı Boolean parametresi. |
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 parametresi. 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 parametresi.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 parametresi.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 parametresi.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[] parametresi.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 TypeLibFiles öğe meta verileri bölümüne bakın. |
TypeLibNames |
İsteğe bağlı ITaskItem[] parametresi.Çö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 TypeLibNames öğe meta verileri bölümüne bakın. |
WrapperOutputDirectory |
İsteğe bağlı String parametresi.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.
| Metadata | Description |
|---|---|
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 tanımlayıcı, 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 varsayılan "0" 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. Tür kitaplıklarının kullanılabilir, büyük/küçük harfe duyarsız seçimleri ş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 olduğundan 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.
| Metadata | Description |
|---|---|
EmbedInteropTypes |
İsteğe bağlı Boolean parametresi.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. Tür kitaplıklarının kullanılabilir, büyük/küçük harfe duyarsız seçimleri ş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 olduğundan 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. |
Note
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.
Remarks
Bu makalede 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 Error
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 yürütülebilir dosya 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.