SoapDocumentMethodAttribute.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

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

Exempel

Följande kodexempel är en XML-webbtjänstmetod som inte kräver att klienten väntar tills XML-webbtjänstmetoden har slutförts. Därför anger OneWay exemplet egenskapen till 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

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 du 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 som tillämpas på dem med egenskapen OneWay inställd på true, har du 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.

Se även

• SoapServerMessage