remote script文檔(轉(zhuǎn)載自微軟)(五)

2019-11-18 22:28:57

字體：大中小

供稿：網(wǎng)友

文檔: 調(diào)用 Remote Scripting 方法同步

在對某個客戶頁和某個服務(wù)器頁上的 remote scripting 進(jìn)行配置后，您就可以從自己的客戶腳本調(diào)用該服務(wù)器頁的方法了。缺省的情況是，當(dāng)用戶調(diào)用某個服務(wù)器方法時(shí)，它被同步執(zhí)行──您的客戶腳本直到服務(wù)器方法執(zhí)行完畢并返回結(jié)果后才能停止運(yùn)行。一般說來，當(dāng)您在自己的客戶腳本中需要服務(wù)器方法結(jié)果時(shí)，則需同步調(diào)用服務(wù)器方法。

注意您也可以異步調(diào)用服務(wù)器方法。有關(guān)詳細(xì)信息，請參閱異步調(diào)用 Remote Scripting 方法。

當(dāng)您調(diào)用某個服務(wù)器方法時(shí)，該方法并不返回單個值。而是創(chuàng)建一個 call object ，它是一個包含了被調(diào)用過程的返回和狀態(tài)信息的對象。最常用的屬性是調(diào)用對象的 return_value 屬性，它包含了遠(yuǎn)程過程計(jì)算或者檢查出來的單個值。其他調(diào)用對象屬性使得用戶可以得到更多關(guān)于遠(yuǎn)程過程調(diào)用的狀態(tài)信息。

如果您已經(jīng)創(chuàng)建了對某個服務(wù)器頁的對象引用，那么可以用標(biāo)準(zhǔn) object.method 語法來調(diào)用方法。有關(guān)創(chuàng)建對象引用的詳細(xì)信息，請參閱作為對象引用 asp 頁。另外，您也可以在沒有任何對象引用時(shí)調(diào)用 remote scripting 方法。這樣做比起使用 object.method 語法來要略微冗余些，但不需要用戶首先創(chuàng)建對象引用。

同步調(diào)用服務(wù)器方法

如果用戶創(chuàng)建了對服務(wù)器頁的對象引用，那么對于使用 javaScript 的調(diào)用，可用第一個語法示例，而對于使用 VBScript 的調(diào)用，可用第二種語法示例：
Javascript:
callObject = ASPObject.methodName(p1, p2[,...])

VBScript:
set callObject = ASPObject.methodName(p1, p2[,...])

- 或者 -

如果用戶沒有創(chuàng)建對象引用，調(diào)用 RSExecute 函數(shù)。對于使用 JavaScript 的調(diào)用，使用第一個語法示例，而對于使用 VBScript 的調(diào)用，使用第二種語法示例：
JavaScript:
callobject = RSExecute(url, methodName, p1, p2[,...])

VBScript:
set callobject = RSExecute(url, methodName, p1, p2[,...])

其中：

callObject 在 remote scripting 調(diào)用完成后，將被實(shí)例化的調(diào)用對象名。您無需在調(diào)用 remote script 之前創(chuàng)建該對象；遠(yuǎn)程腳本調(diào)用為您創(chuàng)建之。

ASPObject 您在早期使用 RSGetASPObject 方法可選擇地創(chuàng)建的對象引用。有關(guān)詳細(xì)信息，請參閱作為對象引用 ASP 頁。

url 包含您想要執(zhí)行的遠(yuǎn)程腳本的 ASP 頁的 URL。必須已將服務(wù)器頁配置為使得服務(wù)器頁中的 Remote Scripting 有效中所描述的那樣。服務(wù)器頁必須在用戶從中請求當(dāng)前客戶頁的服務(wù)器上。

methodName 您想要執(zhí)行的服務(wù)器頁上的方法名。

p1, p2, ... methodName中的方法所需要的任何參數(shù)。參數(shù)是通過值來傳遞的。用戶可以傳遞簡單的數(shù)據(jù)類型，比如數(shù)值或者文本值，但不能傳遞結(jié)構(gòu)化數(shù)據(jù)，比如數(shù)組或者對象。
注意當(dāng)把參數(shù)從客戶傳遞給服務(wù)器時(shí)，它們被轉(zhuǎn)換為字符串。要確保您的服務(wù)器方法在使用參數(shù)時(shí)，將之轉(zhuǎn)換為合適的數(shù)據(jù)類型。有關(guān)詳細(xì)問題，請參閱使得服務(wù)器頁中的 Remote Scripting 有效。

例如，下面按鈕 btnAdd 的客戶腳本 onclick 處理程序調(diào)用服務(wù)器方法 add 來累加兩個數(shù)值。調(diào)用 remote scripting 方法會創(chuàng)建一個名為 co 的調(diào)用對象。remote scripting 調(diào)用的結(jié)果從調(diào)用對象的 return_value 屬性中提取出來，并作為名為 txt3 的文本框值顯示出來。

<SCRIPT LANGUAGE="JavaScript" for="btnAdd" event="onclick">
    rsMath = RSGetASPObject("../myPages/RSMath.asp")
    number1 = txt1.value;
    number2 = txt2.value;
    co = rsMath.Add(number1,number2);
    txt3.value = "The sum is " + co.return_value;
</SCRIPT>

在無對象引用情況下所產(chǎn)生的同樣調(diào)用（用 RSExecute ）可能如下所示：

<SCRIPT LANGUAGE="JavaScript" for="btnAdd" event="onclick">
    number1 = txt1.value;
    number2 = txt2.value;
    co = RSExecute("RSmath.asp","add",number1,number2);
    txt3.value = "The sum is " + co.return_value;
</SCRIPT>

有關(guān)在產(chǎn)生 remote scripting 調(diào)用時(shí)，如何檢查錯誤的詳細(xì)信息，請參閱檢查錯誤。

上一篇：remote script文檔(轉(zhuǎn)載自微軟)(六)

下一篇：remote script文檔(轉(zhuǎn)載自微軟)(四)