COM sarmalayıcıları nasıl oluşturulur

Not

Bu kılavuz .NET Framework'e özgüdür. Modern .NET COM birlikte çalışması için kaynak tarafından üretilen COM birlikte çalışma özelliğini veya System.Runtime.InteropServices.ComWrappers API'sini kullanın. Daha fazla bilgi için bkz. COM birlikte çalışma genel bakışı ve COM kaynak oluşturma.

Visual Studio özelliklerini veya .NET Framework araçları Tlbimp.exe ve Regasm.exe kullanarak Bileşen Nesne Modeli (COM) sarmalayıcıları oluşturabilirsiniz. Her iki yöntem de iki tür COM sarmalayıcı oluşturur:

Visual Studio'da, COM sarmalayıcısını projenize başvuru olarak ekleyebilirsiniz.

Yönetilen uygulamada COM nesnelerini sarmalayın

Visual Studio kullanarak çalışma zamanı çağrılabilen sarmalayıcı oluşturmak için

  1. Yönetilen uygulamanız için projeyi açın.

  2. Proje menüsünde Tüm Dosyaları Göster'e tıklayın.

  3. Proje menüsünde Başvuru Ekle'ye tıklayın.

  4. Başvuru Ekle iletişim kutusunda COM sekmesine tıklayın, kullanmak istediğiniz bileşeni seçin ve Tamam'a tıklayın.

    Çözüm Gezgini'da, COM bileşeninin projenizdeki Başvurular klasörüne eklendiğini unutmayın.

Artık COM nesnesine erişmek için kod yazabilirsiniz. Visual Basic için Imports ifadesi veya C# için Using yönergesi gibi nesneyi bildirerek başlayabilirsiniz.

Not

Microsoft Office bileşenlerini programlamak istiyorsanız, önce Microsoft Office Birincil Birlikte Çalışabilirlik Derlemeleri Yeniden Dağıtılabilir Paketi'ni yükleyin.

.NET Framework araçlarını kullanarak çalışma zamanı çağrılabilen sarmalayıcı oluşturmak için

Bu araç, özgün tür kitaplığında tanımlanan türler için çalışma zamanı meta verilerini içeren bir derleme oluşturur.

Yerel bir uygulamada yönetilen nesneleri sarmalama

Visual Studio kullanarak COM çağrılabilen sarmalayıcı oluşturmak için

  1. Yerel kodda çalıştırmak istediğiniz yönetilen sınıf için bir Sınıf Kitaplığı projesi oluşturun. sınıfı parametresiz bir oluşturucuya sahip olmalıdır.

    AssemblyInfo dosyasında derlemeniz için tam dört parçalı bir sürüm numarasına sahip olduğunuzu doğrulayın. Bu sayı, Windows kayıt defterinde sürüm oluşturmanın korunması için gereklidir. Sürüm numaraları hakkında daha fazla bilgi için bkz: Derleme Sürümlerinin Yönetimi.

  2. Proje menüsünde Özellikler'e tıklayın.

  3. Derle sekmesine tıklayın.

  4. COM birlikte çalışabilirliği için kaydet onay kutusunu seçin.

Projeyi derlediğinizde, derleme COM birlikte çalışabilirliği için otomatik olarak kaydedilir. Visual Studio'da yerel uygulama geliştiriyorsanız, Proje menüsündeki Başvuru Ekle seçeneğine tıklayarak derlemeyi kullanabilirsiniz.

.NET Framework araçlarını kullanarak COM tarafından çağrılabilen sarmalayıcı oluşturma

Regasm.exe (Derleme Kayıt Aracı) aracını çalıştırın.

Bu araç derleme meta verilerini okur ve gerekli girdileri kayıt defterine ekler. Sonuç olarak, COM istemcileri saydam olarak .NET Framework sınıfları oluşturabilir. Derlemeyi yerel bir COM sınıfıymış gibi kullanabilirsiniz.

Regasm.exe herhangi bir dizinde bulunan bir derlemede çalıştırabilir ve ardından genel derleme önbelleğine taşımak için Gacutil.exe (Genel Bütünleştirilmiş Kod Önbelleği Aracı) çalıştırabilirsiniz. Derleme başka bir yerde bulunmazsa genel derleme önbelleği her zaman incelendiğinden, derlemenin taşınması konum kayıt defteri girdilerini geçersiz kılmaz.

Ayrıca bkz.