Comportamento GetObject e CreateObject de servidores de automatização do Office

Este artigo descreve os diferentes comportamentos que ocorrem quando utiliza as funções GetObject e CreateObject com várias versões de aplicações do Microsoft Office. GetObject e CreateObject são funções que são fornecidas pelo Microsoft Visual Basic e Microsoft Visual Basic for Applications (VBA). No entanto, as informações também se aplicam ao Microsoft Visual C++ se processar as referências para GetObject como chamadas para GetActiveObject API e referências a CreateObject como chamadas para CoCreateInstance API.

GetObject

GetObject é utilizado para ligar a uma instância em execução de um servidor de automatização. Existem algumas formas diferentes de chamada a GetObject , mas a sintaxe é recomendada para o Microsoft Office aplicações é o seguinte: se uma instância do Microsoft Excel estiver em execução quando este código é executado, tiver acesso ao modelo de objecto da instância em execução a variável xlApp. Se nenhuma instância estiver em execução, receberá a seguinte mensagem de detectável run-time error: Se estiverem a executar várias instâncias do Microsoft Excel, GetObject liga à instância que é iniciado pela primeira vez. Se, em seguida, fechar a primeira ocorrência, outra chamada a GetObject anexa a segunda ocorrência que foi iniciada e assim sucessivamente.

Pode anexar a uma instância específica, se souber o nome de um documento abrir essa instância. Por exemplo, se uma instância do Excel estiver em execução com um livro aberto com o nome Book2, o seguinte código anexa com êxito a essa instância mesmo que não seja a primeira instância que foi iniciada:

CreateObject

CreateObject é utilizado para iniciar uma nova instância de um servidor de automatização. Por exemplo: dependendo se o servidor foi concebido como SingleUse ou MultiUse, outro processo de servidor pode ou não pode ser iniciado. Isto pode ser uma diferença importante para decidir se deve forçar encerrar uma automatização instância. Por exemplo, com um servidor MultiUse, se uma instância já estiver em execução antes de os anexar, em seguida, poderá evitar a encerrar o servidor programaticamente quando tiver terminado automatizá-lo.

A tabela seguinte funciona como uma referência útil ao implementar uma solução com o Microsoft Office. Lista os comportamentos e atributos de várias versões e aplicações do Microsoft Office, tal como se o servidor assume como predefinição a ser visível quando iniciado, se for SingleUse ou MultiUse, se tiver um UserControl propriedade, se tiver um método de Sair e o nome de classe para a janela principal.


O nome de classe de janela é útil para chamar a API FindWindow quando pretender saber convenientemente se qualquer já está a ser executado. UserControl propriedade é uma propriedade booleana que indica se a aplicação de servidor encerra automaticamente quando a última referência é disponibilizada (definida como nada). O método quit permite-lhe substituir a propriedade UserControl nos casos em que é necessário (por exemplo, quando uma instância não encerra após a última referência comercialização).

Em geral, a Microsoft recomenda que utilize uma nova instância de uma aplicação do Office em vez de anexar a uma instância que o utilizador poderá estar a utilizar. É melhor criar uma instância utilizando ProgID de aplicações e, em seguida, abrir ou criar novos objectos a partir daí. Outros ProgID, tais como Excel.folha e Word.Document e por aí em diante, destinam-se para utilização no OLE (objecto de ligação e incorporação) e pode devolver resultados inconsistentes quando utilizado com CreateObject . Ao utilizar o ProgID de aplicações, evitar potenciais problemas iniciando explicitamente o servidor de automatização (não incorporar).

Quando tiver terminado com o servidor de automatização, libertar todas as referências ao mesmo e chamar o método quit (se disponível) para que o servidor é encerrado como previsto. Se pretende configurar uma instância através de automatização e, em seguida, deixe aberta para o utilizador a utilizar, terá de definir a propriedade UserControl para TRUE e, em seguida, libertar todas as referências. O servidor permanece em seguida, executar (porque a propriedade UserControl é TRUE ) e é encerrado correctamente quando o utilizador fecha a aplicação (porque existem sem referências pendentes).

Nota Para o Word, a propriedade de UserControl é só de leitura. Não pode ser definido como VERDADEIRO ou FALSO. Word sempre permanece em execução quando a última referência é lançada.

Para obter mais informações sobre como utilizar GetObject/CreateObject e para obter informações sobre algumas excepções e problemas relacionados com utilizando a automatização para Microsoft Office, clique em números de artigo que se seguem para visualizar os artigos na base de dados de conhecimento da Microsoft: