Tài liệu Remote Script (trích từ Microsoft) (5)

Bài viết này chủ yếu giới thiệu các tài liệu liên quan đến remote scripting (kịch bản từ xa), dành cho những ai cần tìm hiểu cách cấu hình, gọi các phương thức từ phía máy chủ và xử lý kịch bản đồng bộ và bất đồng bộ. Hy vọng bài viết này sẽ cung cấp thông tin hữu ích cho những người cần tham khảo.

以下是您提供的文本翻译成越南语：

---

Tài liệu: Gọi phương thức Remote Scripting đồng bộ

Sau khi cấu hình remote scripting trên một trang khách và một trang máy chủ, bạn có thể gọi các phương thức của trang máy chủ từ mã JavaScript của mình. Mặc định, khi người dùng gọi một phương thức máy chủ, nó sẽ được thực thi đồng bộ — mã khách của bạn sẽ không dừng lại cho đến khi phương thức máy chủ thực thi xong và trả về kết quả. Thông thường, khi bạn cần kết quả từ phương thức máy chủ trong mã khách của mình, bạn sẽ phải gọi phương thức máy chủ một cách đồng bộ.

Lưu ý: Bạn cũng có thể gọi phương thức máy chủ một cách bất đồng bộ. Để biết thêm chi tiết, vui lòng tham khảo “Gọi phương thức Remote Scripting bất đồng bộ”.

Khi bạn gọi một phương thức máy chủ, phương thức này không trả về một giá trị đơn lẻ. Thay vào đó, nó tạo ra một đối tượng gọi (call object), là một đối tượng chứa thông tin về quá trình gọi và trạng thái trả về. Thuộc tính phổ biến nhất là thuộc tính return_value của đối tượng gọi, nó chứa giá trị đơn lẻ được tính toán hoặc kiểm tra từ quá trình gọi từ xa. Các thuộc tính khác của đối tượng gọi cho phép người dùng có được thêm thông tin về trạng thái của cuộc gọi từ xa.

Nếu bạn đã tạo ra một tham chiếu đối tượng tới một trang máy chủ, bạn có thể gọi phương thức bằng cú pháp chuẩn object.method. Để biết chi tiết về cách tạo tham chiếu đối tượng, vui lòng tham khảo “Tạo tham chiếu đối tượng ASP”. Ngoài ra, bạn cũng có thể gọi phương thức remote scripting mà không cần tham chiếu đối tượng nào. Cách này hơi dư thừa so với việc sử dụng cú pháp object.method, nhưng không yêu cầu người dùng phải tạo trước tham chiếu đối tượng.

Gọi phương thức máy chủ đồng bộ

Nếu người dùng đã tạo tham chiếu đối tượng tới trang máy chủ, đối với các cuộc gọi sử dụng JavaScript, bạn có thể sử dụng cú pháp mẫu đầu tiên, còn đối với các cuộc gọi sử dụng VBScript, bạn có thể sử dụng cú pháp mẫu thứ hai:

JavaScript:

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

VBScript:

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

Hoặc

Nếu người dùng chưa tạo tham chiếu đối tượng, bạn có thể gọi hàm RSExecute. Đối với các cuộc gọi sử dụng JavaScript, bạn có thể sử dụng cú pháp mẫu đầu tiên, còn đối với các cuộc gọi sử dụng VBScript, bạn có thể sử dụng cú pháp mẫu thứ hai:

JavaScript:

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

VBScript:

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

Giải thích các tham số:

• callObject: Là tên của đối tượng gọi được tạo ra khi cuộc gọi remote scripting hoàn tất. Bạn không cần phải tạo đối tượng này trước khi gọi remote script; cuộc gọi remote script sẽ tự động tạo nó cho bạn.

• ASPObject: Là tham chiếu đối tượng mà bạn có thể tạo ra tùy chọn trước đó bằng phương thức RSGetASPObject. Để biết chi tiết, vui lòng tham khảo “Tạo tham chiếu đối tượng ASP”.

• url: URL của trang ASP chứa remote script mà bạn muốn thực thi. Trang máy chủ phải được cấu hình đúng cách để remote scripting hoạt động như đã mô tả. Trang máy chủ phải nằm trên máy chủ mà người dùng yêu cầu trang khách hiện tại.

• methodName: Tên của phương thức trên trang máy chủ mà bạn muốn thực thi.

• p1, p2, …: Các tham số cần thiết cho phương thức methodName. Các tham số này được truyền bằng giá trị. Người dùng có thể truyền các kiểu dữ liệu đơn giản như số hoặc văn bản, nhưng không thể truyền dữ liệu có cấu trúc như mảng hoặc đối tượng.

Lưu ý: Khi truyền tham số từ khách hàng đến máy chủ, các tham số sẽ được chuyển đổi thành chuỗi. Đảm bảo rằng phương thức máy chủ của bạn sẽ chuyển đổi chúng thành các kiểu dữ liệu phù hợp khi sử dụng. Để biết chi tiết, vui lòng tham khảo “Cấu hình Remote Scripting trên trang máy chủ”.

Ví dụ, dưới đây là mã xử lý sự kiện onclick của nút btnAdd trong mã khách gọi phương thức máy chủ add để cộng hai giá trị. Việc gọi phương thức remote scripting sẽ tạo một đối tượng gọi có tên là co. Kết quả của cuộc gọi remote scripting được lấy từ thuộc tính return_value của đối tượng gọi và hiển thị dưới dạng giá trị của hộp văn bản có tên là 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>

Cuộc gọi tương tự không sử dụng tham chiếu đối tượng (sử dụng RSExecute) có thể trông như sau:

<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>

Để biết chi tiết về cách kiểm tra lỗi khi tạo cuộc gọi remote scripting, vui lòng tham khảo “Kiểm tra lỗi”.