SoapClientMessage.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 SoapClientMessage
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 nicht wartet, bis eine Methode vollständig vom Server verarbeitet wurde.

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-Webdienstclient gesendeten und von diesem 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.

 newStream.Position = 0
 Dim myFileStream As New FileStream(filename, FileMode.Append, _
    FileAccess.Write)
 Dim myStreamWriter As New StreamWriter(myFileStream)
 myStreamWriter.WriteLine( _
    "================================== Request at " & DateTime.Now)

 ' 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 client that invoked
 ' the XML Web service method.
 myStreamWriter.WriteLine("The type of the client is: ")
 If message.Client.GetType().Equals(GetType(MathSvc)) Then
    myStreamWriter.WriteLine(ControlChars.Tab & "MathSvc")
 End If

' Print to the log file the method invoked by the client.
 myStreamWriter.WriteLine( _
    "The method that has been invoked by the client is:")
 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 method.
 myStreamWriter.WriteLine( _
    "The url of the XML Web service method that has been requested is: ")
 myStreamWriter.WriteLine(ControlChars.Tab & message.Url)
 myStreamWriter.WriteLine("The contents of the SOAP envelope are: ")
 myStreamWriter.Flush()

 ' Copy the contents of one stream to another. 
 Copy(newStream, myFileStream)
 myStreamWriter.Close()
 myFileStream.Close()
 newStream.Position = 0

 ' Copy the contents of one stream to another. 
 Copy(newStream, oldStream)

newStream.Position = 0;
FileStream myFileStream = new FileStream(filename, FileMode.Append,
   FileAccess.Write);
StreamWriter myStreamWriter = new StreamWriter(myFileStream);
myStreamWriter.WriteLine(
   "================================== Request at "
   + DateTime.Now);

// 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 client that invoked 
// the XML Web service method.
myStreamWriter.WriteLine("The type of the client is: ");
if((message.Client.GetType()).Equals(typeof(MathSvc)))
   myStreamWriter.WriteLine("\tMathSvc");

// Print to the log file the method invoked by the client.
myStreamWriter.WriteLine(
   "The method that has been invoked by the client is:");
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 method.
myStreamWriter.WriteLine(
   "The URL of the XML Web service method that has been requested is: ");
myStreamWriter.WriteLine("\t" + message.Url);
myStreamWriter.WriteLine("The contents of the SOAP envelope are: ");
myStreamWriter.Flush();

// Copy the contents of one stream to another. 
Copy(newStream, myFileStream);
myFileStream.Close();
newStream.Position = 0;

// Copy the contents of one stream to another. 
Copy(newStream, oldStream);

newStream->Position = 0;
FileStream^ myFileStream = gcnew FileStream( filename, FileMode::Append,
   FileAccess::Write );
StreamWriter^ myStreamWriter = gcnew StreamWriter( myFileStream );
myStreamWriter->WriteLine(
   "================================== Request at {0}", DateTime::Now );

// Print to the log file the request header field for SoapAction header.
myStreamWriter->WriteLine( "The SoapAction Http request header field is: " );
myStreamWriter->WriteLine( "\t{0}", message->Action );

// Print to the log file the type of the client that invoked 
// the XML Web service method.
myStreamWriter->WriteLine( "The type of the client is: " );
if ( (message->Client->GetType())->Equals( typeid<MathSvc^> ) )
{
   myStreamWriter->WriteLine( "\tMathSvc" );
}

// Print to the log file the method invoked by the client.
myStreamWriter->WriteLine(
   "The method that has been invoked by the client is:" );
myStreamWriter->WriteLine( "\t{0}", 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 method.
myStreamWriter->WriteLine(
   "The URL of the XML Web service method that has been requested is: " );
myStreamWriter->WriteLine( "\t{0}", message->Url );
myStreamWriter->WriteLine( "The contents of the SOAP envelope are: " );
myStreamWriter->Flush();

// Copy the contents of one stream to another. 
Copy( newStream, myFileStream );
myFileStream->Close();
newStream->Position = 0;

// Copy the contents of one stream to another. 
Copy( newStream, oldStream );

newStream.set_Position(0);
FileStream myFileStream = new FileStream(fileName, FileMode.Append, 
    FileAccess.Write);
StreamWriter myStreamWriter = new StreamWriter(myFileStream);
myStreamWriter.WriteLine("================================== "
    + "Request at " + DateTime.get_Now());
// 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.get_Action());
// Print to the log file the type of the client that invoked 
// the XML Web service method.
myStreamWriter.WriteLine("The type of the client is: ");
if (message.get_Client().GetType().Equals(MathSvc.class.ToType())) {
    myStreamWriter.WriteLine("\tMathSvc");
}
// Print to the log file the method invoked by the client.
myStreamWriter.WriteLine("The method that has been invoked by "
    + "the client is:");
myStreamWriter.WriteLine("\t" + message.get_MethodInfo().get_Name());
// Print to the log file if the method invoked is OneWay.
if (message.get_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 method.
myStreamWriter.WriteLine("The URL of the XML Web service method that "
    + "has been requested is: ");
myStreamWriter.WriteLine("\t" + message.get_Url());
myStreamWriter.WriteLine("The contents of the SOAP envelope are: ");
myStreamWriter.Flush();
// Copy the contents of one stream to another. 
Copy(newStream, myFileStream);
myFileStream.Close();
newStream.set_Position(0);
// Copy the contents of one stream to another. 
Copy(newStream, oldStream);

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SoapClientMessage-Klasse
SoapClientMessage-Member
System.Web.Services.Protocols-Namespace
OneWay

Freigeben über