SoapDocumentMethodAttribute.OneWay Propriedade

Definição

Namespace:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Obtém ou define se um cliente de serviço Web XML aguarda até que o servidor Web conclua o processamento de um método de serviço 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

Valor da propriedade

Boolean

true se o cliente do serviço Web XML não aguardar o servidor Web processar por completo um método de serviço Web XML. O valor padrão é false.

Exemplos

O exemplo de código a seguir é um método de serviço Web XML que não exige que o cliente aguarde a conclusão do método de serviço Web XML. Portanto, o exemplo define a OneWay propriedade como true.

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

Comentários

Quando um método de serviço Web XML tem a OneWay propriedade definida como true, o cliente de serviço Web XML não precisa esperar que o servidor Web conclua o processamento do método de serviço Web XML. Assim que o servidor Web desserializar o SoapServerMessagemétodo de serviço Web XML, mas antes de invocar o método de serviço Web XML, o servidor retornará um código de status HTTP 202. Um código de status HTTP 202 indica ao cliente que o servidor Web começou a processar a mensagem. Portanto, um cliente de serviço Web XML não recebe nenhuma confirmação de que o servidor Web processou a mensagem com êxito.

Os métodos unidirecionais não podem ter um valor retornado ou parâmetros externos.

Se você estiver usando os métodos de serviço Web .NET Framework versão 1.0 XML que têm o atributo ou o SoapRpcMethodAttribute atributo aplicado a eles com a OneWay propriedade do conjunto, truenão tenha acesso ao uso HttpContext da propriedade estáticaCurrent.SoapDocumentMethodAttribute Para acessar a HttpContextclasse que implementa o método de WebService serviço Web XML e acessar a Context propriedade.

Confira também

• SoapServerMessage