SoapDocumentMethodAttribute.OneWay Propiedad

Definición

Espacio de nombres:

System.Web.Services.Protocols

Ensamblado:

System.Web.Services.dll

Obtiene o establece si un cliente de servicios Web XML debe esperar a que el servidor Web termine de procesar un método de servicios 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 de propiedad

Boolean

true si el cliente de servicios Web XML no espera a que el servidor Web termine de procesar completamente un método de servicios Web XML. El valor predeterminado es false.

Ejemplos

El ejemplo de código siguiente es un método de servicio web XML que no requiere que el cliente espere a que se complete el método de servicio web XML. Por lo tanto, el ejemplo establece la OneWay propiedad en 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

Comentarios

Cuando un método de servicio web XML tiene la OneWay propiedad establecida trueen , el cliente del servicio web XML no tiene que esperar a que el servidor web termine de procesar el método de servicio web XML. En cuanto el servidor web haya deserializado , SoapServerMessagepero antes de invocar el método de servicio web XML, el servidor devuelve un código de estado HTTP 202. Un código de estado HTTP 202 indica al cliente que el servidor web ha iniciado el procesamiento del mensaje. Por lo tanto, un cliente de servicio web XML no recibe ninguna confirmación de que el servidor web procesó correctamente el mensaje.

Los métodos unidireccionales no pueden tener un valor devuelto ni ningún parámetro out.

Si usa los métodos de servicio web XML de .NET Framework versión 1.0 que tienen el SoapRpcMethodAttribute atributo o SoapDocumentMethodAttribute aplicado a ellos con la OneWay propiedad de establecida trueen , no tiene acceso a su HttpContext mediante la propiedad estática Current . Para acceder a HttpContext, derive la clase que implementa el método de servicio web XML desde WebService y acceda a la Context propiedad .

Consulte también

• SoapServerMessage