SoapClientMessage Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.Services.Protocols

Bütünleştirilmiş Kod:: System.Web.Services.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Gönderilen SOAP isteğindeki verileri veya belirli SoapMessageStagebir XML Web hizmeti istemcisi tarafından alınan SOAP yanıtını temsil eder. Bu sınıf devralınamaz.

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

Devralma: Object

SoapMessage
SoapClientMessage

Örnekler

Aşağıdaki kod parçası, bir XML Web hizmeti istemcisi tarafından gönderilen ve alınan SOAP iletilerini günlüğe kaydeden bir SOAP uzantısının parçasıdır. Bu belirli parça, öğesinin SoapClientMessage özelliklerini SoapClientMessage günlük dosyasına yazarak SOAP uzantısının yöntemine geçirileni SoapExtension.ProcessMessage işler.

// 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

Özellikler

Action	`SOAPAction` SOAP isteği veya SOAP yanıtı için HTTP isteği üst bilgisi alanını alır.
Client	öğesinden türetilen istemci proxy sınıfının bir örneğini SoapHttpClientProtocolalır.
ContentEncoding	HTTP üst bilgisinin `Content-Encoding` içeriğini alır veya ayarlar. (Devralındığı yer: SoapMessage)
ContentType	SOAP isteğinin veya SOAP yanıtının HTTP'sini `Content-Type` alır veya ayarlar. (Devralındığı yer: SoapMessage)
Exception	SoapException XML Web hizmeti yöntemi çağrısından öğesini alır. (Devralındığı yer: SoapMessage)
Headers	Geçerli SOAP isteğine veya SOAP yanıtına uygulanan SOAP üst bilgileri koleksiyonu. (Devralındığı yer: SoapMessage)
MethodInfo	SOAP isteğinin amaçlandığı XML Web hizmeti yönteminin yöntem prototipinin bir gösterimini alır.
OneWay	İstemcinin sunucunun bir XML Web hizmeti yöntemini işlemeyi tamamlayıp bitirmediğini belirten bir değer alır.
SoapVersion	XML Web hizmetiyle iletişim kurmak için kullanılan SOAP protokolünün sürümünü alır.
SoapVersion	XML Web hizmetiyle iletişim kurmak için kullanılan SOAP protokolünün sürümünü alır. (Devralındığı yer: SoapMessage)
Stage	öğesinin SoapMessageStage öğesini alır SoapMessage. (Devralındığı yer: SoapMessage)
Stream	SOAP isteğini veya SOAP yanıtını temsil eden verileri biçiminde Streamalır. (Devralındığı yer: SoapMessage)
Url	XML Web hizmetinin URL'sini alır.

Yöntemler

EnsureInStage()	Türetilmiş bir sınıfta geçersiz kılındığında, geçerlinin SoapMessageStage parametrelerin kullanılabilir olduğu bir aşama olduğunu onaylar. (Devralındığı yer: SoapMessage)
EnsureOutStage()	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli SoapMessageStage aşamanın out parametrelerinin kullanılabilir olduğu bir aşama olduğunu onaylar. (Devralındığı yer: SoapMessage)
EnsureStage(SoapMessageStage)	SoapMessageStage XML Web hizmeti yöntemine yapılan çağrının geçirilen aşama veya aşama olduğundan emin olun. Geçerli işleme aşaması geçirilen aşamalardan biri değilse, bir özel durum oluşturulur. (Devralındığı yer: SoapMessage)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetInParameterValue(Int32)	Belirtilen dizinde XML Web hizmeti yöntemine geçirilen parametreyi alır. (Devralındığı yer: SoapMessage)
GetOutParameterValue(Int32)	Belirtilen dizinde XML Web hizmeti yöntemine geçirilen out parametresini alır. (Devralındığı yer: SoapMessage)
GetReturnValue()	XML Web hizmeti yönteminin dönüş değerini alır. (Devralındığı yer: SoapMessage)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Şunlara uygulanır

Aracılığıyla paylaş