SoapRpcMethodAttribute.OneWay SoapRpcMethodAttribute.OneWay SoapRpcMethodAttribute.OneWay SoapRpcMethodAttribute.OneWay Property

Определение

Получает или задает значение, указывающее, ожидает ли клиент веб-службы XML окончания обработки веб-сервером метода веб-службы XML.Gets or sets whether an XML Web service client waits for the Web server to finish processing an XML Web service method.

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

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

Значение true, если клиент XML-веб-службы не ожидает завершения обработки веб-сервером метода XML-веб-службы; в противном случае — значение false.true if the XML Web service client does not wait for the Web server to completely process an XML Web service method; otherwise, false. Значение по умолчанию — false.The default is false.

Примеры

В следующем примере кода OneWay свойства true.The following code example sets the OneWay property to 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-веб-службы веб-сервера.When an XML Web service method has the OneWay property set to true, the XML Web service client does not have to wait for the Web server to finish processing the XML Web service method. Как только веб-сервер десериализован SoapServerMessage, но перед вызовом метода XML-веб-службы, то сервер возвращает код состояния HTTP 202.As soon as the Web server has deserialized the SoapServerMessage, but before it invokes the XML Web service method, the server returns an HTTP 202 status code. Код состояния HTTP 202 указывает клиенту на то, что веб-сервер начал обработку сообщения.An HTTP 202 status code indicates to the client that the Web server has started processing the message. Таким образом клиент XML-веб-службы не получает уведомления, веб-сервер успешно обработала сообщение.Therefore, an XML Web service client receives no acknowledgment that the Web server successfully processed the message.

Односторонние методы не могут иметь возвращаемое значение или out параметров.One-way methods cannot have a return value or any out parameters.

Если вы используете .NET Framework версии 1.0 XML-веб-службе методы, имеющие SoapRpcMethodAttribute или SoapDocumentMethodAttribute атрибут, примененный к ним с OneWay свойству присвоено true, запретите доступ к их HttpContext с помощью статические Current свойство.If you are using the .NET Framework version 1.0 XML Web service methods that have either the SoapRpcMethodAttribute or SoapDocumentMethodAttribute attribute applied to them with the OneWay property set to true, do not allow access to their HttpContext using the static Current property. Чтобы получить доступ к HttpContext, являются производными класса, реализующего метод XML-веб-службы из WebService и получить доступ к Context свойство.To access the HttpContext, derive the class implementing the XML Web service method from WebService and access the Context property.

Применяется к