Jak używać Aspose.Words dla .NET za pośrednictwem COM Interop
Informacje zawarte w tym temacie dotyczą scenariuszy, w których chcesz używać Aspose.Words dla .NET za pośrednictwem COM Interop w dowolnym z następujących języków programowania:
- ASP
- Delphi (Przykład) -JScript
- Perl
- PHP
- Konstruktor mocy
- Python -Skrypt VB
- Visual Basic
Pracuj z COM Interop
Aspose.Words dla .NET jest wykonywany pod kontrolą pliku .NET Framework i nazywa się to kodem zarządzanym. Kod napisany we wszystkich powyższych językach działa poza formatem .NET Framework i nazywany jest kodem niezarządzanym. Interakcja między kodem niezarządzanym a Aspose.Words odbywa się za pośrednictwem narzędzia .NET zwanego COM Interop.
Obiekty Aspose.Words są obiektami .NET, ale użyte w formacie COM Interop w Twoim języku programowania pojawiają się jako obiekty COM. Dlatego najlepiej jest upewnić się, że wiesz, jak tworzyć i używać obiektów COM w swoim języku programowania, zanim zaczniesz używać Aspose.Words.
Oto tematy, które ostatecznie będziesz musiał opanować:
- Używanie obiektów COM w swoim języku programowania. Zobacz dokumentację języka programowania i tematy dotyczące poszczególnych języków w dalszej części tej dokumentacji.
- Praca z obiektami COM eksponowanymi przez .NET COM Interop. Zobacz Interoperowanie za pomocą kodu niezarządzanego i Ekspozycja komponentów .NET Framework na COM w MSDN.
- Obiektowy model dokumentu Aspose.Words. Zobacz Aspose.Words Przewodnik programisty i API Reference.
Zarejestruj Aspose.Words dla .NET z COM Interop
Po Instalacja musisz zarejestrować Aspose.Words dla COM Interop za pomocą narzędzia regasm.exe.
regasm.exe to narzędzie zawarte w formacie .NET Framework SDK. Wszystkie narzędzia .NET Framework SDK znajdują się w katalogu %windir%\Microsoft .NET\Framework\<FrameworkVersion>\, na przykład C:\Windows\Microsoft .NET\Framework\v4.0.30319.
Aby uzyskać plik tlb, uruchom C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe <installdir>\lib\net40-client\Aspose.Words.dll /tlb /codebase w cmd, gdzie <installdir> to katalog, w którym zainstalowałeś Aspose.Words, zazwyczaj %USERPROFILE%\.nuget\packages\aspose.words\.
Pracuj z Aspose.Words poprzez COM Interop
ProgIDs
ProgID oznacza “identyfikator programowy”, jest to nazwa klasy COM, której należy użyć, aby utworzyć obiekt.
Obecnie Aspose.Words definiuje cztery publicznie tworzone obiekty COM. Ich ProgIDs to:
- ComHelper
- Dokument
- Kreator dokumentów
- Licencja
ProgIDs składa się z nazwy biblioteki (“Aspose.Words”) i nazwy klasy.
Wpisz bibliotekę
Podczas instalacji plik Aspose.Words.tlb (biblioteka typów COM) jest kopiowany na komputer do:
-Dla .NET Framework 4.0 do
Jeśli Twój język programowania (na przykład Visual Basic lub Delphi) pozwala na odwoływanie się do biblioteki typów COM, dodaj odwołanie do Aspose.Words.tlb, a będziesz mógł zobaczyć wszystkie klasy, metody, właściwości i wyliczenia Aspose.Words w swojej przeglądarce obiektów.
Tworzenie obiektów COM
Tworzenie obiektu .NET przebiega podobnie do tworzenia normalnego obiektu COM:
VBScript
Słaby pomocnik
Ustaw pomocnika = CreateObject("Aspose.Words.ComHelper")
Po utworzeniu możesz uzyskać dostęp do metod i właściwości obiektu, tak jakby był to obiekt COM:
VBScript
Ciemny doktor
Ustaw doc = pomocnik.Open("C:\my.doc")
Niektóre metody mają przeciążenia i zostaną ujawnione przez COM Interop z dodanym sufiksem numerycznym, z wyjątkiem pierwszej metody, która pozostaje niezmieniona. Na przykład przeciążenia metod Document.Save stają się Document.Save, Document.Save_2, Document.Save_3 i tak dalej.
Aby uzyskać więcej informacji, zobacz artykuły dotyczące poszczególnych języków w dalszej części tej dokumentacji.
Tworzenie zespołu opakowania
Jeśli chcesz użyć wielu klas, metod i właściwości Aspose.Words, rozważ utworzenie zestawu opakowania (przy użyciu C# lub dowolnego innego języka programowania .NET), który pomoże uniknąć używania Aspose.Words bezpośrednio z kodu niezarządzanego.
Dobrym podejściem jest opracowanie zestawu .NET, który odwołuje się do Aspose.Words i wykonuje z nim całą pracę, a jednocześnie udostępnia niezarządzany kod jedynie minimalny zestaw klas i metod. Twoja aplikacja powinna wtedy działać tylko z biblioteką opakowań.
Zmniejszenie liczby klas i metod, które należy wywołać za pośrednictwem COM Interop, może uprościć projekt, ponieważ używanie klas .NET za pośrednictwem COM Interop często wymaga zaawansowanych umiejętności.