Connected, proprietà

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di Windows.]

Descrizione

Restituisce o imposta un valore che indica se il controllo corrente è connesso al server di Microsoft Agent.

sintassi

*agent.*Connected [ = boolean]

Parte	Descrizione
booleano	Espressione booleana che specifica se il controllo è connesso. True Il controllo è connesso.

Osservazioni

In molte situazioni, specificando il controllo viene creata automaticamente una connessione con il server di Microsoft Agent. Ad esempio, specificando il CLSID del controllo Microsoft Agent nel tag <OBJECT> in una pagina Web viene aperta automaticamente una connessione server e la pagina viene chiusa. Analogamente, per Visual Basic o altri linguaggi che consentono di eliminare un controllo in una maschera, l'esecuzione del programma apre automaticamente una connessione e chiude la connessione. Se il server non è attualmente in esecuzione, viene avviato automaticamente.

Tuttavia, se si vuole creare un controllo Agent in fase di esecuzione, potrebbe anche essere necessario aprire in modo esplicito una nuova connessione al server usando la proprietà Connected. In Visual Basic, ad esempio, è possibile creare un oggetto ActiveX in fase di esecuzione usando l'istruzione Set con la parola chiave Nuova (o funzione CreateObject). Anche se crea l'oggetto, potrebbe non creare la connessione al server. È possibile utilizzare la proprietà Connected prima di qualsiasi codice che chiama nell'interfaccia di programmazione di Microsoft Agent, come illustrato nell'esempio seguente:

   ' 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

La creazione di un controllo tramite questa tecnica non espone gli eventi del controllo Agent. In Visual Basic 5.0 (e versioni successive) è possibile accedere agli eventi del controllo includendo il controllo nei riferimenti del progetto e usare la parola chiave WithEvents nella dichiarazione di variabile:

   Dim WithEvents MyAgent as Agent

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

L'uso di WithEvents per creare un'istanza del controllo Agent in fase di esecuzione apre automaticamente la connessione con il server Microsoft Agent. Pertanto, non è necessario includere un'istruzione Connected.

È possibile chiudere la connessione al server rilasciando tutti i riferimenti creati agli oggetti Agent, ad esempio IAgentCtlCharacterEx e IAgentCtlCommandEx. È anche necessario rilasciare il riferimento al controllo Agent stesso. In Visual Basic è possibile rilasciare un riferimento a un oggetto impostandone la variabile su Nothing. Se sono stati caricati caratteri, scaricarli prima di rilasciare l'oggetto carattere.

   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

Nota

Non è possibile chiudere la connessione al server rilasciando riferimenti in cui è stato aggiunto il componente. Ad esempio, non è possibile chiudere la connessione al server nelle pagine Web in cui si utilizza il tag> OBJECT <per dichiarare il controllo o in un'applicazione Visual Basic in cui si rilascia il controllo in una maschera. Durante il rilascio di tutti i riferimenti di Agent si ridurrà il working set di Agent, la connessione rimane fino a quando non si passa alla pagina successiva o si esce dall'applicazione.