SoapDocumentMethodAttribute.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 metode layanan Web XML sepenuhnya. Nilai defaultnya adalah false.

Contoh

Contoh kode berikut adalah metode layanan Web XML yang tidak mengharuskan klien untuk menunggu metode layanan Web XML selesai. Oleh karena itu, sampel mengatur properti ke OneWaytrue.

<%@ WebService Language="C#" Class="Stats" %>
 
 using System.Web.Services;
 using System.Web.Services.Protocols;
 
 public class Stats: WebService {
 
      [ SoapDocumentMethod(OneWay=true) ]
      [ WebMethod(Description="Starts nightly statistics batch process.") ]
      public void StartStatsCrunch() {
         // Begin nightly statistics crunching process.
         // A one-way method cannot have return values.
      }      
 
 }

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

Public Class Stats
    Inherits WebService
        
    <SoapDocumentMethod(OneWay := True), _
    WebMethod(Description := "Starts nightly statistics batch process.")> _
    Public Sub _
        StartStatsCrunch()
        
        ' Begin nightly statistics crunching process.
        ' A one-way method cannot have return values.
    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 keluar apa pun.

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

Lihat juga

• SoapServerMessage