MessageQueueException Класс

Определение

Пространство имен:

System.Messaging

Сборка:

System.Messaging.dll

Исключение, возникающее, если происходит внутренняя ошибка в очереди сообщений (Майкрософт).

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

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

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 уже получил совмещаемый доступ к очереди.

Тег alert не поддерживается!!!!
MessageQueueTransaction имеет значение threading-apartment-aware. Visual Basic задает состояние главного потока STAв , поэтому необходимо применить MTAThreadAttribute в подпрограмме Main . В противном случае при отправке транзакционного сообщения с помощью другого потока создастся исключение MessageQueueException.

Конструкторы

MessageQueueException(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр класса MessageQueueException с сериализованными данными.

Свойства

Data	Возвращает коллекцию пар «ключ-значение», предоставляющую дополнительные сведения об исключении. (Унаследовано от Exception)
ErrorCode	Возвращает HRESULT ошибки. (Унаследовано от ExternalException)
HelpLink	Получает или задает ссылку на файл справки, связанный с этим исключением. (Унаследовано от Exception)
HResult	Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению. (Унаследовано от Exception)
InnerException	Возвращает экземпляр класса Exception, который вызвал текущее исключение. (Унаследовано от Exception)
Message	Получает значение, описывающее ошибку Message Queuing.
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