Connected-Eigenschaft

[Der Microsoft-Agent ist ab Windows 7 veraltet und kann in nachfolgenden Versionen von Windows nicht verfügbar sein.]

Beschreibung

Gibt zurück oder legt fest, ob das aktuelle Steuerelement mit dem Microsoft Agent-Server verbunden ist.

Syntax

*agent.*Connected [ = booleschen]

Teil	Beschreibung
booleschen	Ein boolescher Ausdruck, der angibt, ob das Steuerelement verbunden ist. True Das Steuerelement ist verbunden.

Bemerkungen

In vielen Situationen erstellt die Angabe des Steuerelements automatisch eine Verbindung mit dem Microsoft Agent-Server. Wenn Sie beispielsweise die CLSID des Microsoft Agent-Steuerelements im <OBJECT-> Tag auf einer Webseite angeben, wird automatisch eine Serververbindung geöffnet und die Seite beendet. Ebenso öffnet das Ausführen des Programms für Visual Basic oder andere Sprachen, mit denen Sie ein Steuerelement auf einem Formular ablegen können, automatisch eine Verbindung und das Beenden des Programms schließt die Verbindung. Wenn der Server derzeit nicht ausgeführt wird, wird er automatisch gestartet.

Wenn Sie jedoch zur Laufzeit ein Agent-Steuerelement erstellen möchten, müssen Sie möglicherweise auch explizit eine neue Verbindung mit dem Server öffnen, indem Sie die Eigenschaft Connected verwenden. In Visual Basic können Sie z. B. zur Laufzeit ein ActiveX-Objekt mit der Set-Anweisung mit dem Schlüsselwort "New" (oder der CreateObject-Funktion) erstellen. Während dadurch das Objekt erstellt wird, wird möglicherweise keine Verbindung mit dem Server hergestellt. Sie können die Connected-Eigenschaft vor code verwenden, der die Programmierschnittstelle des Microsoft-Agents aufruft, wie im folgenden Beispiel gezeigt:

   ' 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

Das Erstellen eines Steuerelements mithilfe dieser Technik macht die Ereignisse des Agent-Steuerelements nicht verfügbar. In Visual Basic 5.0 (und höher) können Sie auf die Ereignisse des Steuerelements zugreifen, indem Sie das Steuerelement in die Verweise Ihres Projekts einschließen und das schlüsselwort WithEvents in der Variablendeklaration verwenden:

   Dim WithEvents MyAgent as Agent

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

Die Verwendung WithEvents zum Erstellen einer Instanz des Agent-Steuerelements zur Laufzeit öffnet automatisch die Verbindung mit dem Microsoft Agent-Server. Daher müssen Sie keine Connected-Anweisung einschließen.

Sie können die Verbindung mit dem Server schließen, indem Sie alle Verweise freigeben, die Sie für Agent-Objekte erstellt haben, z. B. IAgentCtlCharacterEx und IAgentCtlCommandEx. Sie müssen auch Ihren Verweis auf das Agent-Steuerelement selbst freigeben. In Visual Basic können Sie einen Verweis auf ein Objekt freigeben, indem Sie dessen Variable auf Nothingfestlegen. Wenn Sie Zeichen geladen haben, entladen Sie sie, bevor Sie das Zeichenobjekt freigeben.

   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