SoapRpcMethodAttribute.OneWay Egenskap

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

Egenskapsvärde

trueom XML-webbtjänstklienten inte väntar på att webbservern ska bearbeta en XML-webbtjänstmetod helt; annars . false Standardvärdet är false.

Exempel

I följande kodexempel anges OneWay egenskapen till 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

Kommentarer

När en XML-webbtjänstmetod har OneWay egenskapen inställd truepå behöver XML-webbtjänstklienten inte vänta tills webbservern har slutfört bearbetningen av XML-webbtjänstmetoden. Så snart webbservern har deserialiserat SoapServerMessage, men innan den anropar XML-webbtjänstmetoden returnerar servern en HTTP 202-statuskod. En HTTP 202-statuskod anger för klienten att webbservern har börjat bearbeta meddelandet. Därför får en XML-webbtjänstklient ingen bekräftelse på att webbservern har bearbetat meddelandet.

Enkelriktade metoder kan inte ha ett returvärde eller några out parametrar.

Om du använder xml-webbtjänstmetoderna .NET Framework version 1.0 som antingen har attributet SoapRpcMethodAttribute eller SoapDocumentMethodAttribute tillämpat på dem med egenskapen OneWay inställd på true, tillåt inte åtkomst till deras HttpContext med egenskapen static Current. För att komma åt HttpContext, härled klassen som implementerar XML-webbtjänstmetoden från WebService och få åtkomst till Context egenskapen.