SoapRpcMethodAttribute.OneWay Properti

Definisi

Ruang nama:

System.Web.Services.Protocols

Rakitan:

System.Web.Services.dll

Mendapatkan atau mengatur apakah klien layanan Web XML menunggu server Web selesai memproses metode layanan Web XML.

public:
 property bool OneWay { bool get(); void set(bool value); };

public bool OneWay { get; set; }

member this.OneWay : bool with get, set

Public Property OneWay As Boolean

Nilai Properti

Boolean

true jika klien layanan Web XML tidak menunggu server Web memproses sepenuhnya metode layanan Web XML; jika tidak, false. Defaultnya adalah false.

Contoh

Contoh kode berikut mengatur properti ke OneWaytrue.

<%@ WebService Language="C#" Class="Stats" %>
 
 using System.Web.Services;
 using System.Web.Services.Protocols;
 
 public class Stats: WebService {
 
      [ SoapRpcMethod(OneWay=true) ]
      [ WebMethod(Description="Starts nightly stats batch process.") ]
      public void StartStatsCrunch() {
         // Begin a process that takes a long time to complete.
      }      
 
 }

<%@ WebService Language="VB" Class="Stats" %>
 
Imports System.Web.Services
Imports System.Web.Services.Protocols

Public Class Stats
    Inherits WebService
        
    <SoapRpcMethod(OneWay := True), _
    WebMethod(Description := "Starts nightly stats batch process.")> _
    Public Sub _
        StartStatsCrunch()
        ' Begin a process that takes a long time to complete.
    End Sub
End Class

Keterangan

Ketika metode layanan Web XML memiliki properti yang OneWay diatur ke true, klien layanan Web XML tidak perlu menunggu server Web selesai memproses metode layanan Web XML. Segera setelah server Web mendeserialisasi SoapServerMessage, tetapi sebelum memanggil metode layanan Web XML, server mengembalikan kode status HTTP 202. Kode status HTTP 202 menunjukkan kepada klien bahwa server Web telah mulai memproses pesan. Oleh karena itu, klien layanan Web XML tidak menerima pengakuan bahwa server Web berhasil memproses pesan.

Metode satu arah tidak dapat memiliki nilai pengembalian atau parameter apa pun out .

Jika Anda menggunakan metode layanan Web XML .NET Framework versi 1.0 yang memiliki SoapRpcMethodAttribute atribut atau SoapDocumentMethodAttribute yang diterapkan padanya dengan OneWay properti yang diatur ke true, jangan izinkan akses ke menggunakan HttpContext properti statis Current . Untuk mengakses HttpContext, dapatkan kelas yang mengimplementasikan metode layanan Web XML dari WebService dan mengakses Context properti .