Tlbimp.exe (Tür Kitaplığı İçeri Aktarıcı)
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.dll
bir 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.dll
adı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.dll
için SomeMethod
aşağıdaki yöntem imzasını üretir.
void SomeMethod(out bool x);
Ayrıca bkz.
- Araçlar
- Tlbexp.exe (Tür Kitaplığı Dışarı Aktarıcı)
- Tür Kitaplığını Bütünleştirilmiş Kod Olarak İçeri Aktarma
- Tür Kitaplığı-Derleme Dönüştürme Özeti
- Ildasm.exe (IL Ayrıştırıcı)
- Sn.exe (Tanımlayıcı Ad Aracı)
- Kesin Adlandırılmış Bütünleştirilmiş Kodlar
- Tür Kitaplıklarını Birlikte Çalışma Derlemelerine aktarma öznitelikleri
- Geliştirici komut satırı kabukları