Aracılığıyla paylaş

Tlbimp.exe (Tür Kitaplığı İçeri Aktarıcı)

  • Makale

Tür Kitaplığı İçeri Aktarma programı, COM tür kitaplığı içinde bulunan tür tanımlarını bir ortak dil çalışma zamanı derlemesi içindeki eşdeğer tanımlara dönüştürür. Tlbimp.exe'nin çıktısı, özgün tür kitaplığı içinde tanımlanan türler için çalışma zamanı meta verileri içeren bir ikili dosyadır (derleme). Bu dosyayı Ildasm.exe gibi araçlarla inceleyebilirsiniz.

Bu araç, Visual Studio ile birlikte otomatik olarak yüklenir. Aracı çalıştırmak için Visual Studio Geliştirici Komut İstemi'ni veya Visual Studio Geliştirici PowerShell'i kullanın.

Komut istemine şunu yazın:

Sözdizimi

tlbimp tlbFile [options]

Parametreler

Bağımsız değişken Açıklama
tlbFile COM tür kitaplığı içeren herhangi bir dosyanın adı.
Seçenek Açıklama
/asmversion: versionnumber Üretilecek derlemenin sürüm numarasını belirtir. versionnumber değerini major.minor.build.revision biçiminde belirtin.
/şirket: companyinformation Şirket bilgilerini çıktı derlemesine ekler.
/telif hakkı: copyrightinformation Çıktı derlemesine telif hakkı bilgileri ekler. Bu bilgiler derlemenin Dosya Özellikleri iletişim kutusunda görüntülenebilir.
/delaysign Elde edilen ve tanımlayıcı bir ada sahip olan derlemeyi gecikmeli imzalama yöntemiyle imzalamak için kullanılacak Tlbimp.exe'yi belirtir. Bu seçeneği /keycontainer:, /keyfile: veya /publickey: seçeneğiyle belirtmeniz gerekir. Gecikmeli imzalama işlemi hakkında daha fazla bilgi için bkz . Derleme İmzalama gecikmesi.
/Yardım Araç için komut sözdizimini ve seçenekleri görüntüler.
/keycontainer: containername Containername tarafından belirtilen anahtar kapsayıcısında bulunan ortak/özel anahtar çiftini kullanarak sonuçta elde edilen derlemeyi bir tanımlayıcı adla imzalar.
/keyfile: dosya adı Sonuçta elde edilen derlemeyi, yayımcının dosya adında bulunan resmi ortak/özel anahtar çiftini kullanarak kesin bir adla imzalar.
/makine: machinetype Belirtilen makine türünü (mikro işlemci) hedefleyen bir derleme oluşturur. Desteklenen makine türleri: x86, x64, Itanium ve Belirsiz.
/namespace: ad alanı Derlemenin oluşturulacağı ad alanını belirtir.
/noclassmembers Tlbimp.exe'nin sınıflara üye eklemesini önler. Bu, olası TypeLoadExceptionbir öğesini önler.
/nologo Microsoft başlangıç başlığı görüntüsünü bastırır.
/out: dosya adı İçine meta veri tanımlarının yazılacağı çıktı dosyasının, derlemenin ve ad alanının adını belirtir. Tür kitaplığı, derlemenin ad alanını açıkça denetleen Arabirim Tanım Dili (IDL) özel özniteliğini belirtiyorsa /out seçeneğinin derlemenin ad alanı üzerinde hiçbir etkisi yoktur. Bu seçeneği belirtmezseniz, Tlbimp.exe, girdi dosyasında tanımlanan asıl tür kitaplığıyla aynı ada sahip bir dosyaya meta verileri yazar ve ona bir .dll uzantısı atar. Çıktı dosyasının adı girdi dosyasının adıyla aynı ise, araç tür kitaplığı üzerine yazılmasını engellemek için bir hata üretir.
/birincil Belirtilen tür kitaplığı için bir birincil birlikte çalışma derlemesi oluşturur. Derlemeyi tür kitaplığı yayıncısının oluşturduğunu belirten bilgiler derlemeye eklenir. Birincil birlikte çalışma derlemesi belirterek, bir yayıncının derlemesini, Tlbimp.exe kullanarak tür kitaplığından oluşturulan diğer derlemelerden ayırt edersiniz. /primary seçeneğini yalnızca Tlbimp.exe ile içeri aktardığınız tür kitaplığının yayımcısıysanız kullanmalısınız. Birincil birlikte çalışma derlemeyi tanımlayıcı bir adla imzalamanız gerektiğini unutmayın. Daha fazla bilgi için bkz . Birincil Birlikte Çalışma Derlemeleri.
/ürün: productinformation Çıktı derlemesine ürün bilgileri ekler. Bu bilgiler derlemenin Dosya Özellikleri iletişim kutusunda görüntülenebilir.
/productversion: productversioninformation Çıktı derlemesine ürün sürümü ile ilgili bilgiler ekler. Biçim kısıtlamaları yoktur. Bu bilgiler derlemenin Dosya Özellikleri iletişim kutusunda görüntülenebilir.
/publickey: dosya adı Elde edilen derlemeyi imzalamak için kullanılacak ortak anahtarı içeren dosyayı belirtir. /publickey: yerine /keyfile: veya /keycontainer: seçeneğini belirtirseniz, Tlbimp.exe ortak anahtarı /keyfile: veya /keycontainer: ile sağlanan ortak/özel anahtar çiftinden oluşturur. /publickey: seçeneği test anahtarını ve imzalamayı geciktirme senaryolarını destekler. Dosya, Sn.exe tarafından üretilen biçimdedir. Daha fazla bilgi için, Tanımlayıcı Ad Aracı'nda (Sn.exe) Sn.exe -p seçeneğine bakın.
/reference: dosya adı Geçerli tür kitaplığı dışında tanımlanmış tür başvurularını çözümlemek için kullanılacak derleme dosyasını belirtir. /reference seçeneğini belirtmezseniz, Tlbimp.exe içeri aktarılan tür kitaplığının başvurduğunu tüm dış tür kitaplıklarını otomatik olarak özyinelemeli olarak içeri aktarır. /reference seçeneğini belirtirseniz, araç diğer tür kitaplıklarını içeri aktarmadan önce başvuruda bulunan derlemelerdeki dış türleri çözümlemeye çalışır.
/sessizlik: warningnumber Belirtilen uyarının görüntülenmesini bastırır. Bu seçenek /silent ile kullanılamaz.
/silent Başarı iletilerinin görüntülenmesini bastırır. Bu seçenek /silence ile kullanılamaz.
/strictref Araç geçerli derlemedeki tüm başvuruları, /reference seçeneğiyle belirtilen derlemeleri veya kayıtlı birincil birlikte çalışma derlemelerini (PIA) çözümleyemediğinde tür kitaplığını içeri aktarmaz.
/strictref:nopia /strictref ile aynı, ancak PIA'ları yoksayar.
/sysarray Yönetilen Array tür olarak Bir COM stili SafeArray içeri aktarmak için aracı belirtir.
/tlbreference: filename Kayıt defterine danışmadan tür kitaplığı başvurularını çözümlemek için kullanılacak tür kitaplığı dosyasını belirtir.

Bu seçeneğin bazı eski tür kitaplığı biçimlerini yüklenmediğini unutmayın. Ancak, kayıt defteri veya geçerli dizin aracılığıyla, eski tür kitaplığı biçimlerini dolaylı olarak yine yükleyebilirsiniz.
/Marka: trademarkinformation Çıktı derlemesine ticari marka bilgileri ekler. Bu bilgiler derlemenin Dosya Özellikleri iletişim kutusunda görüntülenebilir.
/transform: transformname Meta verileri transformname parametresi tarafından belirtilen şekilde dönüştürür.

Transformname parametresinin yalnızca dağıtım arabirimlerindeki (dispinterfaces) yöntemlerin [out, retval] parametrelerini dönüş değerlerine dönüştürmesi için dispret değerini belirtin.

Bu seçenek hakkında daha fazla bilgi için bu konunun ilerleyen bölümlerindeki örneklere bakın.
/güvensiz Arabirimleri, .NET Framework güvenlik denetimleri olmadan üretir. Bu şekilde sunulan bir yöntemi çağırmak güvenlik riski oluşturabilir. Bu tür kodları ortaya çıkarmanın getireceği riskleri bilmiyorsanız bu seçeneği kullanmamalısınız.
/verbose Ayrıntılı modu belirtir; içeri aktarılan tür kitaplığı hakkında daha fazla bilgi görüntüler.
/VariantBoolFieldToBool VARIANT_BOOL Yapılardaki alanları öğesine Booleandönüştürür.
/? Araç için komut sözdizimini ve seçenekleri görüntüler.

Not

Tlbimp.exe için komut satırı seçenekleri büyük/küçük harfe duyarlı değildir ve herhangi bir sırayla sağlanabilir. Tek yapmanız gereken, onu benzersiz şekilde tanımlamak için seçeneği yeterince belirtmektir. Bu nedenle, /n / nologo ve /ou ile eşdeğerdir: outfile.dll /out: outfile.dll ile eşdeğerdir.

Açıklamalar

Tlbimp.exe dönüştürmeleri tüm tür Kitaplığında bir defada gerçekleştirir. Tek bir tür kitaplığı içinde tanımlanmış bir tür alt kümesi için tür bilgileri oluştururken bu aracı kullanamazsınız.

Derlemelere tanımlayıcı adlar atayabilmek genellikle yararlıdır veya gereklidir. Bu nedenle, Tlbimp.exe tanımlayıcı adlarla adlandırılmış derlemeler oluşturmak için gereken bilgileri sağlayan seçenekler içerir. Hem /keyfile: hem de /keycontainer: seçenekleri derlemeleri tanımlayıcı adlarla imzalar. Bu nedenle, aynı anda bu seçeneklerden yalnızca birini sağlamak mantıklı olur.

/reference seçeneğini birden çok kez kullanarak birden çok başvuru derlemesi belirtebilirsiniz.

Tlbimp.exe derleme oluşturma yönteminden dolayı, bir derlemeyi farklı mscorlib bir sürüme yeniden hedeflemek mümkün değildir. Örneğin, .NET Framework 2.0'ı hedefleyen bir derleme oluşturmak istiyorsanız. .NET Framework 2.0/3.0/3.5 SDK ile birlikte gönderilen Tlbimp.exe kullanılmalıdır. .NET Framework 4.x'i hedeflemek için .NET Framework 4.x SDK'sı ile birlikte gönderilen Tlbimp.exe kullanılmalıdır.

Birden fazla tür kitaplığı içeren bir modülden bir tür kitaplığını içeri aktarırken, isteğe bağlı olarak tür kitaplık dosyasına bir kaynak kimliği eklenebilir. Tlbimp.exe bu dosyayı yalnızca geçerli dizinde ise ya da tam yolunu belirtirseniz bulabilir. Bu konunun ilerleyen kısımlarındaki örneğe bakın.

Örnekler

Aşağıdaki komut, .dll uzantısında myTest.tlb bulunan tür kitaplığıyla aynı ada sahip bir derleme oluşturur.

tlbimp myTest.tlb

Aşağıdaki komut, adlı myTest.dllbir derleme oluşturur.

tlbimp  myTest.tlb  /out:myTest.dll

Aşağıdaki komut, ve .dll MyModule.dll\1 uzantısıyla belirtilen tür kitaplığıyla aynı ada sahip bir derleme oluşturur. MyModule.dll\1 geçerli dizinde bulunmalıdır.

tlbimp MyModule.dll\1

Aşağıdaki komut, tür kitaplığının TestLib.dlladına myTestLib.dll sahip bir derleme oluşturur. /transform:dispret seçeneği, tür kitaplığındaki dispinterfaces üzerindeki yöntemlerin [out, retval] parametrelerini yönetilen kitaplıktaki dönüş değerlerine dönüştürür.

tlbimp TestLib.dll /transform:dispret /out:myTestLib.dll

Önceki örnekteki tür kitaplığı TestLib.dll, void döndüren ve [out, retval] parametresine sahip olan adlı SomeMethod bir dispinterface yöntemi içerir. Aşağıdaki kod, içinde için SomeMethod giriş türü kitaplık yöntemi imzasıdır TestLib.dll.

void SomeMethod([out, retval] VARIANT_BOOL*);

/transform:dispret seçeneğinin belirtilmesi, Tlbimp.exe parametresini [out, retval] SomeMethod dönüş bool değerine dönüştürmesine neden olur. Aşağıda, /transform:dispret seçeneği belirtildiğinde Tlbimp.exe tarafından yönetilen kitaplıkta myTestLib.dll için SomeMethod oluşturulan yöntem imzası yer alır.

bool SomeMethod();

/transform:dispret belirtmeden için yönetilen kitaplık oluşturmak için TestLib.dll Tlbimp.exe kullanırsanız, araç yönetilen kitaplığında myTestLib.dlliçin SomeMethod aşağıdaki yöntem imzasını üretir.

void SomeMethod(out bool x);

Ayrıca bkz.