SoapClientMessage Klas

Definitie

Naamruimte:: System.Web.Services.Protocols

Assembly:: System.Web.Services.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vertegenwoordigt de gegevens in een SOAP-aanvraag die is verzonden of een SOAP-antwoord dat is ontvangen door een XML-webserviceclient op een specifieke SoapMessageStage. Deze klasse kan niet worden overgenomen.

public ref class SoapClientMessage sealed : System::Web::Services::Protocols::SoapMessage

public sealed class SoapClientMessage : System.Web.Services.Protocols.SoapMessage

type SoapClientMessage = class
    inherit SoapMessage

Public NotInheritable Class SoapClientMessage
Inherits SoapMessage

Overname: Object

SoapMessage
SoapClientMessage

Voorbeelden

Het volgende codefragment maakt deel uit van een SOAP-extensie waarmee de SOAP-berichten worden vastgelegd die worden verzonden en ontvangen door een XML-webserviceclient. Dit specifieke fragment verwerkt de SoapClientMessage doorgegeven methode SoapExtension.ProcessMessage van de SOAP-extensie door eigenschappen van het SoapClientMessage logboekbestand te schrijven.

// Process the SOAP message received and write to a log file.
void ProcessMessage( SoapMessage^ message )
{
   switch ( message->Stage )
   {
      case SoapMessageStage::BeforeSerialize:
         break;
      case SoapMessageStage::AfterSerialize:
         WriteOutput( dynamic_cast<SoapClientMessage^>(message) );
         break;
      case SoapMessageStage::BeforeDeserialize:
         WriteInput( dynamic_cast<SoapClientMessage^>(message) );
         break;
      case SoapMessageStage::AfterDeserialize:
         break;
      default:
         throw gcnew Exception( "invalid stage" );
   }
}

// Write the contents of the outgoing SOAP message to the log file.
void WriteOutput( SoapClientMessage^ message )
{
   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 );
}


// Process the SOAP message received and write to a log file.
public override void ProcessMessage(SoapMessage message)
{
   switch (message.Stage)
   {
      case SoapMessageStage.BeforeSerialize:
         break;
      case SoapMessageStage.AfterSerialize:
         WriteOutput((SoapClientMessage)message);
         break;
      case SoapMessageStage.BeforeDeserialize:
         WriteInput((SoapClientMessage)message);
         break;
      case SoapMessageStage.AfterDeserialize:
         break;
      default:
         throw new Exception("invalid stage");
   }
}

// Write the contents of the outgoing SOAP message to the log file.
public void WriteOutput(SoapClientMessage message)
{
   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);
}

 ' Process the SOAP message received and write to a log file.
 Public Overrides Sub ProcessMessage(message As SoapMessage)
    Select Case message.Stage
       Case SoapMessageStage.BeforeSerialize
       Case SoapMessageStage.AfterSerialize
          WriteOutput(CType(message, SoapClientMessage))
       Case SoapMessageStage.BeforeDeserialize
          WriteInput(CType(message, SoapClientMessage))
       Case SoapMessageStage.AfterDeserialize
       Case Else
             Throw New Exception("invalid stage")
    End Select
 End Sub
 
 
 ' Write the contents of the outgoing SOAP message to the log file.
 Public Sub WriteOutput(message As SoapClientMessage)
    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)
End Sub

Eigenschappen

Name	Description
Action	Hiermee haalt u het `SOAPAction` veld http-aanvraagheader op voor de SOAP-aanvraag of soap-antwoord.
Client	Hiermee haalt u een exemplaar van de clientproxyklasse op, die is afgeleid van SoapHttpClientProtocol.
ContentEncoding	Hiermee haalt u de inhoud van de HTTP-header op of stelt u deze `Content-Encoding` in. (Overgenomen van SoapMessage)
ContentType	Hiermee haalt u de HTTP `Content-Type` van de SOAP-aanvraag of soap-antwoord op of stelt u deze in. (Overgenomen van SoapMessage)
Exception	Hiermee haalt u de SoapException aanroep naar de XML-webservicemethode op. (Overgenomen van SoapMessage)
Headers	Een verzameling SOAP-headers die zijn toegepast op de huidige SOAP-aanvraag of SOAP-antwoord. (Overgenomen van SoapMessage)
MethodInfo	Hiermee haalt u een weergave op van het prototype van de methode van de XML-webservice waarvoor de SOAP-aanvraag is bedoeld.
OneWay	Hiermee wordt een waarde opgehaald die aangeeft of de client wacht totdat de server klaar is met het verwerken van een XML-webservicemethode.
SoapVersion	Hiermee haalt u de versie op van het SOAP-protocol dat wordt gebruikt om te communiceren met de XML-webservice.
Stage	Haalt de SoapMessageStage van de SoapMessage. (Overgenomen van SoapMessage)
Stream	Hiermee haalt u de gegevens op die de SOAP-aanvraag of SOAP-antwoord vertegenwoordigen in de vorm van een Stream. (Overgenomen van SoapMessage)
Url	Hiermee haalt u de URL van de XML-webservice op.

Methoden

Name	Description
EnsureInStage()	Wanneer deze wordt overschreven in een afgeleide klasse, wordt aangegeven dat de huidige SoapMessageStage een fase is waarin parameters beschikbaar zijn. (Overgenomen van SoapMessage)
EnsureOutStage()	Wanneer deze wordt overschreven in een afgeleide klasse, bevestigt u dat de huidige SoapMessageStage fase een fase is waarin parameters beschikbaar zijn. (Overgenomen van SoapMessage)
EnsureStage(SoapMessageStage)	Zorgt ervoor dat de SoapMessageStage aanroep van de XML-webservicemethode de fase of fasen is die worden doorgegeven. Als de huidige verwerkingsfase niet een van de doorgegeven fasen is, wordt er een uitzondering gegenereerd. (Overgenomen van SoapMessage)
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetInParameterValue(Int32)	Hiermee haalt u de parameter op die is doorgegeven aan de XML-webservicemethode op de opgegeven index. (Overgenomen van SoapMessage)
GetOutParameterValue(Int32)	Hiermee haalt u de outparameter op die is doorgegeven aan de XML-webservicemethode op de opgegeven index. (Overgenomen van SoapMessage)
GetReturnValue()	Hiermee haalt u de retourwaarde van een XML-webservicemethode op. (Overgenomen van SoapMessage)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)

Van toepassing op

Feedback

Is deze pagina nuttig?