SoapClientMessage.OneWay Propriedade

Referência

Definição

Namespace:: System.Web.Services.Protocols

Assembly:: System.Web.Services.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém um valor que indica se o cliente aguarda até que o servidor conclua o processamento de um método de serviço Web XML.

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

public override bool OneWay { get; }

member this.OneWay : bool

Public Overrides ReadOnly Property OneWay As Boolean

Valor da propriedade

Boolean

true se o cliente não aguardar o servidor processar completamente um método.

Exemplos

O fragmento de código a seguir faz parte de uma extensão SOAP que registra as mensagens SOAP enviadas e recebidas por um cliente de serviço Web XML. Esse fragmento específico é gerado para esse arquivo de log uma frase informando que o método de serviço Web XML é unidirecional, quando a OneWay propriedade é true.

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

Comentários

Um SoapDocumentMethodAttribute ou SoapRpcMethodAttribute aplicado a um método de serviço Web XML ou ao cliente de serviço Web XML pode especificar se o método de serviço Web XML é uma maneira definindo a OneWay propriedade do atributo.

A OneWay propriedade pode ser acessada durante qualquer SoapMessageStage.

Aplica-se a

Confira também

OneWay

Partilhar via