Comportement de GetObject et CreateObject des serveurs automation Office

Cet article décrit les différents comportements de se produisent lorsque vous utilisez les fonctions GetObject et CreateObject avec différentes versions d'applications Microsoft Office. GetObject et CreateObject sont des fonctions qui sont fournies par Microsoft Visual Basic et Microsoft Visual Basic pour Applications (VBA). Cependant, les informations sont également applicables à Microsoft Visual C++ si vous considérez les références fonction GetObject en tant qu'appels GetActiveObject API et les références à CreateObject que les appels à la fonction CoCreateInstance API.

GetObject

GetObject est utilisé pour associer à une instance en cours d'exécution d'un serveur automation. Il existe quelques manières différentes d'appeler GetObject , mais la syntaxe est recommandée pour Microsoft Office applications est la suivante : si une instance de Microsoft Excel est en exécution lorsque le code est exécuté, vous avez accès à modèle d'objet l'instance en cours d'exécution par le biais de la variable xlApp. Si aucune instance s'exécute, vous recevez le message d'erreur run-time récupérable suivantes : Si exécutent plusieurs instances de Microsoft Excel, GetObject joint à l'instance qui est lancé en premier. Si vous fermez puis la première instance, un autre appel de GetObject attache à la deuxième instance qui a été lancée et ainsi de suite.

Vous pouvez joindre à une instance spécifique si vous connaissez le nom d'un document ouvert dans cette instance. Par exemple, si une instance d'Excel s'exécute avec un classeur ouvert nommé Book2, le code suivant attache avec succès à cette instance même si elle n'est pas l'instance première qui a été lancé :

CreateObject

CreateObject utilisé pour démarrer une nouvelle instance d'un serveur Automation. Par exemple : selon que le serveur est conçu comme SingleUse ou MultiUse, un autre processus serveur peut ou peut ne pas être lancé. Cela peut être une différence importante pour décider si vous devez forcer arrêter une Automation instance. Par exemple, avec un serveur MultiUse, si une instance est en cours d'exécution avant de joindre, puis vous peut-être souhaitez éviter l'arrêt du serveur par programme lorsque vous avez terminé l'automatisation il.

Le tableau suivant sert de référence utile lors de l'implémentation d'une solution avec Microsoft Office. Il répertorie les comportements et attributs des versions différentes et des applications de Microsoft Office, telles que la valeur par défaut si le serveur est soit visible au démarrage, s'il s'agit SingleUse ou MultiUse, si elle possède un contrôle UserControl propriété, si elle possède une méthode Quit et le nom de classe pour la fenêtre principale.


Le nom de classe de la fenêtre principale est utile pour appel FindWindow API lorsque vous souhaitez savoir facilement si n'importe quelle instance est déjà en cours d'exécution. L'objet UserControl propriété est une propriété booléenne qui indique si l'application serveur automatiquement arrête lorsque la dernière référence est publié (ensemble sur nothing). La méthode Quit permet de remplacer la propriété UserControl dans les cas où il est nécessaire (tels que lorsqu'une instance ne s'arrête pas après la dernière référence).

En règle générale, Microsoft recommande d'utiliser une nouvelle instance d'une application Office au lieu de lier à une instance de l'utilisateur peut utiliser. Il est mieux créer une instance en utilisant le ProgID application, ouvrir ou créer des objets à partir de là. Autres ProgID, notamment Excel.Sheet Word.Document et ainsi de suite, est conçus pour être utilisés dans OLE (liaison d'objet and Embedding) et peut donner des résultats incohérents lorsqu'elle est utilisée avec la fonction CreateObject . En utilisant le ProgID application, vous éviter les problèmes potentiels en démarrant explicitement le serveur pour l'automatisation (Embedding).

Lorsque vous avez terminé avec le serveur Automation, libérer toutes vos références et appelle sa méthode Quit (si disponible) afin que le serveur arrête normalement. Si vous souhaitez configurer une instance par l'intermédiaire d'Automation et puis laissez-la ouverte pour l'utilisateur à utiliser, vous devez définir la propriété UserControl sur TRUE et puis relâchez vos références. Le serveur puis reste en cours d'exécution (parce que la propriété UserControl est TRUE ) et s'arrête correctement lorsque l'utilisateur ferme l'application (car il n'existe aucune référence en attente).

note Pour que Word, la propriété UserControl est en lecture seule. Elle ne peut pas être définie sur True ou False. Word toujours reste l'exécution à la dernière référence est libérée.

Pour plus d'informations sur l'utilisation de GetObject/CreateObject et en savoir plus sur certaines exceptions et des problèmes liés à l'utilisation de Automation pour Microsoft Office, cliquez sur les numéros ci-dessous pour afficher les articles correspondants dans la Base de connaissances Microsoft. :