MessageQueueException クラス

定義

名前空間:

System.Messaging

アセンブリ:

System.Messaging.dll

Microsoft Message Queuing の内部エラーが発生した場合にスローされる例外。

public ref class MessageQueueException : System::Runtime::InteropServices::ExternalException

[System.Serializable]
public class MessageQueueException : System.Runtime.InteropServices.ExternalException

[<System.Serializable>]
type MessageQueueException = class
    inherit ExternalException
    interface ISerializable

Public Class MessageQueueException
Inherits ExternalException

継承

Object

Exception

SystemException

ExternalException

MessageQueueException

属性

SerializableAttribute

実装

ISerializable

例

#using <system.dll>
#using <system.messaging.dll>

using namespace System;
using namespace System::Messaging;
int main()
{
   
   // Determine whether the queue exists.
   if ( MessageQueue::Exists( ".\\myQueue" ) )
   {
      try
      {
         
         // Delete the queue.
         MessageQueue::Delete( ".\\myQueue" );
      }
      catch ( MessageQueueException^ e ) 
      {
         if ( e->MessageQueueErrorCode == MessageQueueErrorCode::AccessDenied )
         {
            Console::WriteLine( "Access is denied. Queue might be a system queue." );
         }
         
         // Handle other sources of MessageQueueException.
      }

   }

   return 0;
}

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 verifies existence and attempts to
        // delete a queue.
        //**************************************************

        public static void Main()
        {

            // Determine whether the queue exists.
            if (MessageQueue.Exists(".\\myQueue"))
            {
                try
                {
                    // Delete the queue.
                    MessageQueue.Delete(".\\myQueue");
                }
                catch(MessageQueueException e)
                {
                    if(e.MessageQueueErrorCode ==
                        MessageQueueErrorCode.AccessDenied)
                    {
                        Console.WriteLine("Access is denied. " +
                            "Queue might be a system queue.");
                    }

                    // Handle other sources of MessageQueueException.
                }
            }
        
            return;
        }
    }
}

Imports System.Messaging



Public Class MyNewQueue


        
        ' Provides an entry point into the application.
        '		 
        ' This example verifies existence and attempts to 
        ' delete a queue.
        

        Public Shared Sub Main()

            ' Determine whether the queue exists.
            If MessageQueue.Exists(".\myQueue") Then

                Try

                    ' Delete the queue.
                    MessageQueue.Delete(".\myQueue")

                Catch e As MessageQueueException

                    If e.MessageQueueErrorCode = _
                        MessageQueueErrorCode.AccessDenied Then

                        Console.WriteLine("Access is denied. " _
                            + "Queue might be a system queue.")
                    End If

                    ' Handle other sources of exceptions as necessary.

                End Try

            End If


            Return

        End Sub

End Class

注釈

クラスに MessageQueueException 関連付けられている例外は、コードを通じて処理する必要があるメッセージ キュー内の内部エラーによって生成されます。

すべての例外は、エラー コードと、エラーの原因を説明するテキスト文字列で構成されます。 MessageQueueErrorCodeこれらのエラー コードとその説明の一覧については、 クラスを参照してください。

MessageQueue パラメーターが true に設定されたキューを sharedModeDenyReceive が開いた後に、別の MessageQueue がキューを読み取ろうとすると、共有違反により MessageQueueException 例外が生成されます。 MessageQueue が既にキューに非排他的にアクセスできるときに、別の MessageQueue が排他モードでキューにアクセスしようとした場合にも、同じ例外がスローされます。

alert タグはサポートされていません!!!
MessageQueueTransaction はスレッド化に対応しています。 Visual Basic では、メイン スレッドの状態が にSTA設定されるため、 サブルーチンで をMTAThreadAttribute適用するMain必要があります。 適用しない場合、別のスレッドを使用してトランザクション メッセージを送信すると、MessageQueueException 例外がスローされます。

コンストラクター

MessageQueueException(SerializationInfo, StreamingContext)

シリアル化したデータを使用して、MessageQueueException クラスの新しいインスタンスを初期化します。

プロパティ

Data	例外に関する追加のユーザー定義情報を提供する、キーと値のペアのコレクションを取得します。 (継承元 Exception)
ErrorCode	エラーの HRESULT を取得します。 (継承元 ExternalException)
HelpLink	この例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。 (継承元 Exception)
HResult	特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。 (継承元 Exception)
InnerException	現在の例外の原因となる Exception インスタンスを取得します。 (継承元 Exception)
Message	メッセージ キュー エラーを説明する値を取得します。
MessageQueueErrorCode	この例外に関連付けられているエラー コードを示す値を取得します。
Source	エラーの原因となるアプリケーションまたはオブジェクトの名前を取得または設定します。 (継承元 Exception)
StackTrace	呼び出し履歴で直前のフレームの文字列形式を取得します。 (継承元 Exception)
TargetSite	現在の例外がスローされたメソッドを取得します。 (継承元 Exception)

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetBaseException()	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の根本原因である Exception を返します。 (継承元 Exception)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetObjectData(SerializationInfo, StreamingContext)	シリアル化情報オブジェクトを、MessageQueueException のシリアル化に必要なデータで事前設定します。
GetType()	現在のインスタンスのランタイム型を取得します。 (継承元 Exception)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	エラーの HRESULT が格納された文字列を返します。 (継承元 ExternalException)

イベント

SerializeObjectState

例外がシリアル化され、例外に関するシリアル化されたデータを含む例外状態オブジェクトが作成されたときに発生します。 (継承元 Exception)

こちらもご覧ください

• MessageQueueErrorCode
• MessageQueue
• Message