MessageQueueException 类

定义

命名空间:

System.Messaging

程序集:

System.Messaging.dll

发生 Microsoft 消息队列内部错误时引发的异常。

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 在 sharedModeDenyReceive 参数设置为 true 的情况下打开一个队列，则随后尝试从该队列中进行读取的任何 MessageQueue 都会由于共享冲突而生成 MessageQueueException 异常。 如果一个 MessageQueue 尝试以独占模式访问队列，而此时另一个 MessageQueue 已经以非独占方式访问该队列，则引发与此相同的异常。

不支持警报标记!!!
MessageQueueTransaction 是线程单元感知。 Visual Basic 将main线程的状态设置为 STA，因此必须在子例程中Main应用 MTAThreadAttribute 。 否则，利用另一个线程发送事务性消息将引发 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()	当在派生类中重写时，返回 Exception，它是一个或多个并发的异常的根本原因。 (继承自 Exception)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetObjectData(SerializationInfo, StreamingContext)	使用序列化 MessageQueueException 时所需的数据填充序列化信息对象。
GetType()	获取当前实例的运行时类型。 (继承自 Exception)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回一个字符串，该字符串包含错误的 HRESULT。 (继承自 ExternalException)

事件

SerializeObjectState

当异常被序列化用来创建包含有关该异常的徐列出数据的异常状态对象时会出现该问题。 (继承自 Exception)

另请参阅

• MessageQueueErrorCode
• MessageQueue
• Message