Aspose.PDF para .NET via COM Interop

Trabalhando com COM Interop

Aspose.PDF for .NET é executado sob o controle do .NET Framework e isso é chamado de código gerenciado. O código escrito em todas as linguagens acima é executado fora do .NET Framework e é chamado de código não gerenciado. A interação entre código não gerenciado e Aspose.PDF ocorre através do recurso .NET chamado COM Interop.

Os objetos Aspose.PDF são objetos .NET, mas quando usados via COM Interop, eles aparecem como objetos COM em sua linguagem de programação. Portanto, é melhor garantir que você saiba como criar e usar objetos COM em sua linguagem de programação, antes de começar a usar Aspose.PDF for .NET.

Aqui estão os tópicos que você eventualmente precisará dominar:

Registrar Aspose.PDF for .NET com COM Interop

Você precisa instalar Aspose.PDF for .NET e garantir que ele esteja registrado com COM Interop (assegurando que pode ser chamado a partir de código não gerenciado).

Preste atenção que /codebase é necessário apenas se Aspose.PDF.dll não estiver no GAC, usar esta opção faz com que regasm coloque o caminho da assembly no registro.

ProgIDs

ProgID significa “identificador programático”. É o nome de uma classe COM que é usada para criar um objeto. ProgIDs consistem no nome da biblioteca “Aspose.PDF” e no nome da classe.

Biblioteca de Tipos

Criando Objetos COM

A criação de um objeto COM é semelhante à criação de um objeto .NET normal:

'Instantiate Pdf instance by calling its empty constructor
Dim document
Set document = CreateObject("Aspose.Pdf.Document")

Uma vez criado, você pode acessar os métodos e propriedades do objeto, como se fosse um objeto COM:

'Add page to the document
document.Pages.Add()

Alguns métodos têm sobrecargas e elas serão expostas pelo COM Interop com um sufixo numérico adicionado a elas, exceto pelo primeiro método que permanece inalterado. Por exemplo, as sobrecargas do método Document.Save tornam-se Document.Save, Document.Save_2, e assim por diante.

Para mais informações, consulte os artigos específicos da linguagem mais adiante nesta documentação.

Criando uma Assembly Wrapper

Se você precisar usar muitas classes, métodos e propriedades de Aspose.PDF for .NET, considere criar uma assembly wrapper (usando C# ou qualquer outra linguagem de programação .NET). Assemblies wrapper ajudam a evitar o uso de Aspose.PDF for .NET diretamente a partir de código não gerenciado.

Uma boa abordagem é desenvolver uma assembly .NET que faça referência a Aspose.PDF for .NET e faça todo o trabalho com ela, e apenas exponha um conjunto mínimo de classes e métodos para código não gerenciado. Seu aplicativo deve então funcionar apenas com sua biblioteca wrapper.

Reduzir o número de classes e métodos que você precisa invocar via COM Interop simplifica o projeto. Usar classes .NET via COM Interop frequentemente requer habilidades avançadas.

Tecnologia de Plataforma e Interoperabilidade ASP - VBScript via COM Interop