MessageQueue.Close メソッド

MessageQueue で割り当てられたすべてのリソースを解放します。

Public Sub Close()
[C#]
public void Close();
[C++]
public: void Close();
[JScript]
public function Close();

解説

Close は、 MessageQueue に関連付けられたすべてのリソースを解放します。共有リソースがあれば、共有リソースも解放されます。たとえば、次の C# コードで示すように Send メソッドを呼び出したときに、まだリソースが利用できる場合は、システムがこれらのリソースを自動的に再取得します。

myMessageQueue.Send("Text 1.");
myMessageQueue.Close();
myMessageQueue.Send("Text 2."); //Resources are reaquired.

Close を呼び出すと、メッセージ キューのキューに直接アクセスするすべての MessageQueue プロパティが消去されます。 Path 、 DefaultPropertiesToSend 、 Formatter 、および MessageReadPropertyFilter は、すべてそのまま残ります。

メッセージ キュー サーバーのキューを削除する前に、キューに対して Close を呼び出す必要があります。呼び出さないと、メッセージがキューに送信されたときに例外がスローされたり、配信不能キューに到達することがあります。

このメソッドが各種のワークグループ モードで使用できるかどうかを次の表に示します。

使用例

[Visual Basic, C#, C++] メッセージ キューのキューを閉じる例を次に示します。

 
Imports System
Imports System.Messaging

Namespace MyProject

    '/ <summary>
    '/ Provides a container class for the example.
    '/ </summary>
    Public Class MyNewQueue


        '**************************************************
        ' Provides an entry point into the application.
        '     
        ' This example closes a queue and frees its 
        ' resources.
        '**************************************************

        Public Shared Sub Main()

            ' Create a new instance of the class.
            Dim myNewQueue As New MyNewQueue()

            ' Send a message to a queue.
            myNewQueue.SendMessage()

            ' Receive a message from a queue.
            myNewQueue.ReceiveMessage()

            Return

        End Sub 'Main


        '**************************************************
        ' Sends a message to a queue.
        '**************************************************

        Public Sub SendMessage()

            ' Connect to a queue on the local computer.
            Dim myQueue As New MessageQueue(".\myQueue")

            ' Send a message to the queue.
            myQueue.Send("My message data1.")

            ' Explicitly release resources.
            myQueue.Close()

            ' Attempt to reaquire resources.
            myQueue.Send("My message data2.")

            Return

        End Sub 'SendMessage


        '**************************************************
        ' Receives a message from a queue.
        '**************************************************

        Public Sub ReceiveMessage()

            ' Connect to the a on the local computer.
            Dim myQueue As New MessageQueue(".\myQueue")

            ' Set the formatter to indicate the body contains an 
            ' Order.
            myQueue.Formatter = New XmlMessageFormatter(New Type() _
                {GetType([String])})

            Try
                ' Receive and format the message. 
                Dim myMessage1 As Message = myQueue.Receive()
                Dim myMessage2 As Message = myQueue.Receive()

            Catch
                ' Handle sources of any MessageQueueException.

                ' Catch other exceptions as necessary.

            Finally

                ' Free resources.
                myQueue.Close()

            End Try

            Return

        End Sub 'ReceiveMessage

    End Class 'MyNewQueue
End Namespace 'MyProject

[C#] 
using System;
using System.Messaging;

namespace MyProject
{

    /// <summary>
    /// Provides a container class for the example.
    /// </summary>
    public class MyNewQueue
    {

        //**************************************************
        // Provides an entry point into the application.
        //     
        // This example closes a queue and frees its 
        // resources.
        //**************************************************

        public static void Main()
        {
            // Create a new instance of the class.
            MyNewQueue myNewQueue = new MyNewQueue();

            // Send a message to a queue.
            myNewQueue.SendMessage();

            // Receive a message from a queue.
            myNewQueue.ReceiveMessage();

            return;
        }


        //**************************************************
        // Sends a message to a queue.
        //**************************************************
        
        public void SendMessage()
        {
            // Connect to a queue on the local computer.
            MessageQueue myQueue = new MessageQueue(".\\myQueue");

            // Send a message to the queue.
            myQueue.Send("My message data1.");
            
            // Explicitly release resources.
            myQueue.Close();

            // Attempt to reaquire resources.
            myQueue.Send("My message data2.");

            return;
        }


        //**************************************************
        // Receives a message from a queue.
        //**************************************************
        
        public  void ReceiveMessage()
        {
            // Connect to the a on the local computer.
            MessageQueue myQueue = new MessageQueue(".\\myQueue");

            // Set the formatter to indicate body contains an Order.
            myQueue.Formatter = new XmlMessageFormatter(new Type[]
                {typeof(String)});
            
            try
            {
                // Receive and format the message. 
                Message myMessage1 = myQueue.Receive();
                Message myMessage2 = myQueue.Receive();
            }
            
            catch (MessageQueueException)
            {
                // Handle sources of any MessageQueueException.
            }

            // Catch other exceptions as necessary.

            finally
            {
                // Free resources.
                myQueue.Close();
            }

            return;
        }
    }
}

[C++] 
#using <mscorlib.dll>
#using <system.dll>
#using <system.messaging.dll>

using namespace System;
using namespace System::Messaging;

__gc class MyNewQueue 
{
public:
    // Sends a message to a queue.
    void SendMessage() 
    {
        // Connect to a queue on the local computer.
        MessageQueue* myQueue = new MessageQueue(S".\\myQueue");

        // Send a message to the queue.
        myQueue->Send(S"My message data1.");

        // Explicitly release resources.
        myQueue->Close();

        // Attempt to reaquire resources.
        myQueue->Send(S"My message data2.");

        return;
    }

    // Receives a message from a queue.
    void ReceiveMessage() 
    {
        // Connect to the a on the local computer.
        MessageQueue* myQueue = new MessageQueue(S".\\myQueue");

        // Set the formatter to indicate body contains an Order.
        Type* p __gc[] = new Type* __gc[1];
        p[0] = __typeof(String);
        myQueue->Formatter = new XmlMessageFormatter( p );

        try 
        {
            // Receive and format the message. 
            Message* myMessage1 = myQueue->Receive();
            Message* myMessage2 = myQueue->Receive();
        }
        catch (MessageQueueException*) 
        {
            // Handle sources of any MessageQueueException.
        }

        // Catch other exceptions as necessary.
        __finally 
        {
            // Free resources.
            myQueue->Close();
        }

        return;
    }
};

// Provides an entry point into the application.
// This example closes a queue and frees its 
// resources.
int main() 
{
    // Create a new instance of the class.
    MyNewQueue* myNewQueue = new MyNewQueue();

    // Send a message to a queue.
    myNewQueue->SendMessage();

    // Receive a message from a queue.
    myNewQueue->ReceiveMessage();

    return 0;
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

• 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用

参照

MessageQueue クラス | MessageQueue メンバ | System.Messaging 名前空間 | Delete