Message.Close Methode

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Schließt Message und gibt alle Ressourcen frei.

public:
 void Close();

public void Close ();

member this.Close : unit -> unit

Public Sub Close ()

Beispiele

Das folgende Codebeispiel veranschaulicht das Erstellen einer Nachricht, Senden der Nachricht an einen Dienst und Empfangen einer Antwortnachricht. Der Inhalt der Antwortnachricht wird angezeigt, und die Nachricht wird anschließend geschlossen.

using System;
using System.Collections.Generic;
using System.Text;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.Runtime.Serialization;

namespace ConsoleApplication1
{
    class client
    {

        static void RunClient()
        {
            //Step1: create a binding with just HTTP
            CustomBinding binding = new CustomBinding();
            binding.Elements.Add(new HttpTransportBindingElement());
            //Step2: use the binding to build the channel factory
            IChannelFactory<IRequestChannel> factory =
            binding.BuildChannelFactory<IRequestChannel>(
                             new BindingParameterCollection());
            //open the channel factory
            factory.Open();
            //Step3: use the channel factory to create a channel
            IRequestChannel channel = factory.CreateChannel(
               new EndpointAddress("http://localhost:8080/channelapp"));
            channel.Open();
            //Step4: create a message
            Message requestmessage = Message.CreateMessage(
                MessageVersion.Soap12WSAddressing10,
                "http://contoso.com/someaction",
                 "This is the body data");
            //send message
            Message replymessage = channel.Request(requestmessage);
            Console.WriteLine("Reply message received");
            Console.WriteLine("Reply action: {0}",
                                  replymessage.Headers.Action);
            string data = replymessage.GetBody<string>();
            Console.WriteLine("Reply content: {0}", data);
            //Step5: don't forget to close the message
            requestmessage.Close();
            replymessage.Close();
            //don't forget to close the channel
            channel.Close();
            //don't forget to close the factory
            factory.Close();
        }
        public static void Main()
        {
            Console.WriteLine("Press [ENTER] when service is ready");
            Console.ReadLine();
            RunClient();
            Console.WriteLine("Press [ENTER] to exit");
            Console.ReadLine();
        }
    }
}

Imports System.Collections.Generic
Imports System.Text
Imports System.ServiceModel
Imports System.ServiceModel.Channels
Imports System.Runtime.Serialization

Namespace ConsoleApplication1
    Friend Class client


        Private Shared Sub RunClient()
            'Step1: create a binding with just HTTP
            Dim binding As New CustomBinding()
            binding.Elements.Add(New HttpTransportBindingElement())
            'Step2: use the binding to build the channel factory
            Dim factory As IChannelFactory(Of IRequestChannel) = binding.BuildChannelFactory(Of IRequestChannel)(New BindingParameterCollection())
            'open the channel factory
            factory.Open()
            'Step3: use the channel factory to create a channel
            Dim channel As IRequestChannel = factory.CreateChannel(New EndpointAddress("http://localhost:8080/channelapp"))
            channel.Open()
            'Step4: create a message
            Dim requestmessage As Message = Message.CreateMessage(MessageVersion.Soap12WSAddressing10, "http://contoso.com/someaction", "This is the body data")
            'send message
            Dim replymessage As Message = channel.Request(requestmessage)
            Console.WriteLine("Reply message received")
            Console.WriteLine("Reply action: {0}", replymessage.Headers.Action)
            Dim data = replymessage.GetBody(Of String)()
            Console.WriteLine("Reply content: {0}", data)
            'Step5: don't forget to close the message
            requestmessage.Close()
            replymessage.Close()
            'don't forget to close the channel
            channel.Close()
            'don't forget to close the factory
            factory.Close()
        End Sub
        Public Shared Sub Main()
            Console.WriteLine("Press [ENTER] when service is ready")
            Console.ReadLine()
            RunClient()
            Console.WriteLine("Press [ENTER] to exit")
            Console.ReadLine()
        End Sub
    End Class
End Namespace

Hinweise

Message verfügt über einen Finalizer, wodurch Close bei der Garbage Collection für die Nachricht aufgerufen wird. Dies ist nicht optimal, da der Garbage Collection (GC)-Mechanismus von .NET Framework nicht unbedingt ausgeführt wird, wenn andere Ressourcen als der Arbeitsspeicher zur Neige gehen. Aus diesem Grund sollten Sie diese Methode immer aufrufen, wenn Sie den Inhalt der Nachricht nicht mehr benötigen. Die Close-Methode ist synonym mit Dispose (die ebenfalls durch Message implementiert wird). Die Nachricht gibt außerdem das Objekt frei, das zum Konstruieren des Texts verwendet wurde, wenn er verworfen wird.

Wenn Sie eine Methode aufrufen oder auf Eigenschaften der Nachricht zugreifen, nachdem sie geschlossen wurde, wird eine ObjectDisposedException ausgelöst. Das Aufrufen einer Methode oder Zugreifen auf Eigenschaften anderer Objekte, die sich auf die Nachricht beziehen, nachdem die Nachricht geschlossen wurde (wie z. B. Auflistung der Nachrichtenheader, Eigenschaftswerte der Nachricht oder für den Text bzw. einen Header zurückgegebene XmlReader-Instanzen), weist ein nicht definiertes Verhalten auf.