SoapRpcMethodAttribute.OneWay Свойство

Определение

Пространство имен:

System.Web.Services.Protocols

Сборка:

System.Web.Services.dll

Получает или задает значение, указывающее, ожидает ли клиент веб-службы XML окончания обработки веб-сервером метода веб-службы 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

Значение свойства

Boolean

Значение true, если клиент XML-веб-службы не ожидает завершения обработки веб-сервером метода XML-веб-службы; в противном случае — значение false. Значение по умолчанию — false.

Примеры

В следующем примере кода свойству присваивается OneWay значение true.

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

Комментарии

Если метод веб-службы XML имеет OneWay свойство , то trueклиенту веб-службы XML не нужно ждать завершения обработки метода веб-службы XML на веб-сервере. Как только веб-сервер десериализирует SoapServerMessage, но перед вызовом метода веб-службы XML сервер возвращает код состояния HTTP 202. Код состояния HTTP 202 указывает клиенту, что веб-сервер начал обработку сообщения. Таким образом, клиент веб-службы XML не получает подтверждения того, что веб-сервер успешно обработал сообщение.

Односторонние методы не могут иметь возвращаемое значение или какие-либо out параметры.

Если вы используете методы веб-службы XML платформа .NET Framework версии 1.0, SoapRpcMethodAttribute к которым применен атрибут или SoapDocumentMethodAttribute со свойством OneWay , имеющим значение true, не разрешайте доступ к ним HttpContext с помощью статического Current свойства. Чтобы получить доступ к HttpContext, наследуйте класс, реализуя метод веб-службы XML, от WebService и получите доступ к свойству Context .