İstek Nesnesi

[Microsoft Agent, Windows 7 itibariyle kullanım dışıdır ve sonraki Windows sürümlerinde kullanılamayabilir.]

Sunucu bazı yöntemleri zaman uyumsuz olarak işler. Bu, yöntem tamamlanırken uygulama kodunuzun devam etmesi sağlar. bir istemci uygulaması bu yöntemlerden birini çağırdığında, denetim istek için bir İstek nesnesi oluşturur ve döndürür. yöntemine bir nesne değişkeni atayarak yöntemin durumunu izlemek için request nesnesini kullanabilirsiniz. Visual Basic'te önce bir nesne değişkeni bildirin:

   Dim MyRequest as Object

VBScript'te, bildiriminize değişken türünü eklemezsiniz:

   Dim MyRequest

Değişkeni yöntem çağrısına atamak için Visual Basic'in Set deyimini kullanın:

   Set MyRequest = <i>agent</i>.Characters("<i>CharacterID</i>").<i>method</i> (<i>parameter</i>[s])

İsteği nesnesine bir referans ekler. İstek nesnesine daha fazla başvuru olmadığında yok edilir. İstek nesnesini nerede bildirdiğiniz ve nasıl kullandığınız, onun kullanım ömrünü belirler. Nesne bir alt yordama veya işleve yerel olarak bildirilirse, kapsamın dışına çıktığında yok edilir; diğer bir ifadeyle, alt yordam veya işlev sona erdiğinde. Nesne genel olarak bildirilirse, program sonlandırılana veya nesneye yeni bir değer (veya "boş" olarak ayarlanmış bir değer) atanana kadar yok edilmeyecektir.

İstek nesnesi, sorgulayabileceğiniz çeşitli özellikler sağlar. Örneğin, Durumu özelliği isteğin geçerli durumunu döndürür. İsteğinizin durumunu denetlemek için bu özelliği kullanabilirsiniz:

   Dim MyRequest
   
   Set MyRequest = Agent1.Characters.Load ("Genie", "https://agent.microsoft.com/characters/v2/genie/genie.acf")

   If (MyRequest.Status = 2) then
      'do something

   Else If (MyRequest.Status = 0) then
      'do something right away

   End If

Durumu özelliği, İstek nesnesinin durumunu Uzun tamsayı değeri olarak döndürür.

Durum	Tanım
0	İstek başarıyla tamamlandı.
1	İstek başarısız oldu.
2	İstek bekliyor (kuyrukta, ancak tamamlanmadı).
3	Talep kesildi.
4	İstek devam ediyor.

 

İstek nesnesi, Durum kodunun hatasını veya nedenini döndüren Sayı özelliğinde Bir Uzun tamsayı değeri de içerir. Yoksa, bu değer sıfırdır (0). Description özelliği, hata numarasına karşılık gelen bir dize değeri içerir. Eğer dize mevcut değilse, Açıklama "Uygulama tanımlı veya nesne tanımlı hata" içerir.

Numarası özelliği tarafından döndürülen değerler ve anlamlar için bkz. hata kodları .

Sunucu, animasyon isteklerini belirtilen karakterin kuyruğuna yerleştirir. Bu, sunucunun animasyonu ayrı bir iş parçacığında oynatmasını sağlar ve animasyonlar oynatılırken uygulamanızın kodu devam edebilir. İstek nesne başvurusu oluşturursanız, RequestStart ve RequestComplete olayları aracılığıyla bir animasyon isteği başlatıldığında veya tamamlandığında sunucu sizi otomatik olarak uyarır. İstek nesneleri döndüren yöntemler zaman uyumsuz olduğundan ve çağıran işlevin kapsamı boyunca tamamlanamayabileceğinden, İstek nesnesine olan referansınızı genel olarak tanımlayın.

İstek nesnesini döndürmek için aşağıdaki yöntemler kullanılabilir: İşaret Et, Al, Gizle, Kes, Yükle, Taşı, Oynat, Göster, Konuşve Bekle.