Propriedade Conectada

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]

de descrição do

Retorna ou define se o controle atual está conectado ao servidor do Microsoft Agent.

de sintaxe

*agent.* Conectado [ = booliano ]

Parte	Descrição
booliano	Uma expressão booliana que especifica se o controle está conectado. True O controle está conectado.

Observações

Em muitas situações, especificar o controle cria automaticamente uma conexão com o servidor do Microsoft Agent. Por exemplo, especificar o CLSID do controle do Microsoft Agent na marca <OBJECT> em uma página da Web abre automaticamente uma conexão de servidor e sair da página fecha a conexão. Da mesma forma, para o Visual Basic ou outras linguagens que permitem remover um controle em um formulário, a execução do programa abre automaticamente uma conexão e sair do programa fecha a conexão. Se o servidor não estiver em execução no momento, ele será iniciado automaticamente.

No entanto, se você quiser criar um controle agent em tempo de execução, talvez também precise abrir explicitamente uma nova conexão com o servidor usando a propriedade Connected. Por exemplo, no Visual Basic, você pode criar um objeto ActiveX em tempo de execução usando a instrução Set com a palavra-chave New (ou a função CreateObject). Embora isso crie o objeto, ele pode não criar a conexão com o servidor. Você pode usar a propriedade Connected antes de qualquer código que chame a interface de programação do Microsoft Agent, conforme mostrado no exemplo a seguir:

   ' Declare a global variable for the control
   Dim MyAgent as Agent

   ' Create an instance of the control using New
   Set MyAgent = New Agent

   ' Open a connection to the server
   MyAgent.Connected = True

   ' Load a character
   MyAgent.Characters.Load "Genie", " Genie.acs"

   ' Display the character
   MyAgent.Characters("Genie").Show

A criação de um controle usando essa técnica não expõe os eventos do controle agent. No Visual Basic 5.0 (e posterior), você pode acessar os eventos do controle incluindo o controle nas referências do projeto e usar a palavra-chave WithEvents em sua declaração variável:

   Dim WithEvents MyAgent as Agent

   ' Create an instance of the control using New
   Set MyAgent = New Agent

Usar WithEvents para criar uma instância do controle Agent em tempo de execução abre automaticamente a conexão com o servidor do Microsoft Agent. Portanto, você não precisa incluir uma instrução Connected.

Você pode fechar sua conexão com o servidor liberando todas as referências criadas para objetos do Agent, como IAgentCtlCharacterEx e IAgentCtlCommandEx. Você também deve liberar sua referência para o próprio controle agent. No Visual Basic, você pode lançar uma referência a um objeto definindo sua variável como Nothing. Se você tiver carregado caracteres, descarregue-os antes de liberar o objeto de caractere.

   Dim WithEvents MyAgent as Agent
   Dim Genie as IAgentCtlCharacterEx
   
   Sub Form_Load

   ' Create an instance of the control using New
   Set MyAgent = New Agent

   ' Open a connection to the server
   MyAgent.Connected = True

   ' Load the character into the Characters collection
   MyAgent.Characters.Load "Genie", " Genie.acs"

   ' Create a reference to the character
   Set Genie = MyAgent.Characters("Genie")

   End Sub

   Sub CloseConnection

   ' Unload the character
   MyAgent.Characters.Unload "Genie"

   ' Release the reference to the character object
   Set Genie = Nothing

   ' Release the reference to the Agent control
   Set MyAgent = Nothing
   End Sub