SoapServerMessage.OneWay-Eigenschaft

Artikel
08/20/2007

Ruft einen Wert ab, der angibt, ob der Client den Abschluss der Verarbeitung einer XML-Webdienstmethode durch den Server abwartet.

Namespace: System.Web.Services.Protocols
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public Overrides ReadOnly Property OneWay As Boolean
'Usage
Dim instance As SoapServerMessage
Dim value As Boolean

value = instance.OneWay

public override bool OneWay { get; }

public:
virtual property bool OneWay {
    bool get () override;
}

/** @property */
public boolean get_OneWay ()

public override function get OneWay () : boolean

Eigenschaftenwert

true, wenn der Client wartet, bis der Server eine Methode vollständig verarbeitet hat, andernfalls false.

Hinweise

Ein auf eine XML-Webdienstmethode oder einen XML-Webdienstclient angewendetes SoapDocumentMethodAttribute oder SoapRpcMethodAttribute kann angeben, ob die XML-Webdienstmethode unidirektional ist, indem die OneWay-Eigenschaft des Attributs festgelegt wird.

Auf die OneWay-Eigenschaft kann auf jeder SoapMessageStage zugegriffen werden.

Beispiel

Das folgende Codefragment ist Teil einer SOAP-Erweiterung, mit der die von einem XML-Webdienst gesendeten und empfangenen SOAP-Nachrichten protokolliert werden. Dieses Fragment gibt in die Protokolldatei einen Ausdruck aus, der angibt, dass die XML-Webdienstmethode unidirektional ist, wenn die OneWay-Eigenschaft true ist.

Dim myFileStream As New FileStream(filename, FileMode.Append, FileAccess.Write)
Dim myStreamWriter As New StreamWriter(myFileStream)

' Print to the log file the request header field for SoapAction header.
myStreamWriter.WriteLine("The SoapAction Http request header field is: ")
myStreamWriter.WriteLine((ControlChars.Tab + message.Action))

' Print to the log file the type of the XML Web service.
myStreamWriter.WriteLine("The type of the XML Web service is: ")
If message.Server.GetType().Equals(GetType(MathSvc)) Then
   myStreamWriter.WriteLine(ControlChars.Tab + "MathSvc")
End If

' Print to the log file the name of the XML Web service method.
myStreamWriter.WriteLine("The name of the XML Web service method requested:")
myStreamWriter.WriteLine((ControlChars.Tab + message.MethodInfo.Name))

' Print to the log file if the method invoked is OneWay.
If message.OneWay Then
   myStreamWriter.WriteLine( _
      "The client doesn't wait for the server to finish processing")
Else
   myStreamWriter.WriteLine( _
      "The client waits for the server to finish processing")
End If 

' Print to the log file the URL of the site that provides 
' implementation of the XML Web service method.
myStreamWriter.WriteLine( _
   "The url of the XML Web service method requested: ")
myStreamWriter.WriteLine((ControlChars.Tab + message.Url))
myStreamWriter.Flush()
myStreamWriter.Close()
myFileStream.Close()

FileStream myFileStream = 
   new FileStream(filename, FileMode.Append, FileAccess.Write);
StreamWriter myStreamWriter = new StreamWriter(myFileStream);

// Print to the log file the request header field for SoapAction header.
myStreamWriter.WriteLine("The SoapAction HTTP request header field is: ");
myStreamWriter.WriteLine("\t" + message.Action);

// Print to the log file the type of the XML Web service.
myStreamWriter.WriteLine("The type of the XML Web service is: ");
if((message.Server.GetType()).Equals(typeof(MathSvc)))
   myStreamWriter.WriteLine("\tMathSvc");
   
// Print to the log file the name of the XML Web service method.
myStreamWriter.WriteLine(
   "The method of the XML Web service method requested:");
myStreamWriter.WriteLine("\t" + message.MethodInfo.Name);

// Print to the log file if the method invoked is OneWay.
if(message.OneWay)
   myStreamWriter.WriteLine(
      "The client doesn't wait for the server to finish processing");
else
   myStreamWriter.WriteLine(
      "The client waits for the server to finish processing");
   
// Print to the log file the URL of the site that provides 
// implementation of the XML Web service method.
myStreamWriter.WriteLine(
   "The URL of the requested XML Web service method: ");
myStreamWriter.WriteLine("\t" + message.Url);
myStreamWriter.Flush();
myStreamWriter.Close();
myFileStream.Close();

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

SoapServerMessage-Klasse
SoapServerMessage-Member
System.Web.Services.Protocols-Namespace

Freigeben über