RequestStart-händelse

[Microsoft Agent är inaktuell från och med Windows 7 och kan vara otillgänglig i efterföljande versioner av Windows.]

Beskrivning

Inträffar när servern påbörjar en köbegäran.

syntax

subagent**_RequestStart** (ByValRequest**)**

Del	Beskrivning
Begäran	Returnerar objektet Request.

 

Anmärkningar

Händelsen returnerar ett request-objekt. Eftersom begäranden bearbetas asynkront kan du använda den här händelsen för att avgöra när servern börjar bearbeta en begäran (till exempel en Get, Playeller Speak-metoden) och synkronisera detta med andra åtgärder som genereras av ditt program. Händelsen skickas endast till klienten som skapade referensen till objektet Request och endast om du definierade en global variabel för begärandereferensen:

   Dim MyRequest 
   Dim Genie 

   Sub window_Onload
   
   Agent1.Characters.Load "Genie", _
      "https://agent.microsoft.com/characters/v2/genie/genie.acf"   

   Set Genie = Agent1.Characters("Genie")

   ' This syntax will generate RequestStart and RequestComplete events.
   Set MyRequest = Genie.Get("state", "Showing")

   ' This syntax will not generate RequestStart and RequestComplete events.
   Genie.Get ("state", "Hiding")

   End Sub

   Sub Agent1_RequestStart(ByVal Request)

   If Request = MyRequest Then
      Status = "Loading the Showing animation"

   End Sub

Status returnerar 4 (pågående begäran) för objektet Request returnerade.

Eftersom animering Begär objekt inte tilldelas förrän servern bearbetar begäran, kontrollerar du att objektet Request finns innan du försöker utvärdera det. I Visual Basic kan du till exempel använda nyckelordet Nothing om du använder ett villkor för att testa om en specifik begäran har slutförts:

   Sub Agent1_RequestStart (ByVal Request)

   If Not (MyRequest Is Nothing) Then
      If Request = MyRequest Then
      '-- Do whatever
      End If
   End If

   End Sub

Not

I VBScript 1.0 utlöses den här händelsen även om du inte definierar referenser till ett request-objekt. Detta har åtgärdats i VBScript 2.0.

 

Se även

RequestComplete-händelse