MessageQueueException Класс

Определение

Исключение, возникающее, если происходит внутренняя ошибка в очереди сообщений (Майкрософт).The exception that is thrown if a Microsoft Message Queuing internal error occurs.

public ref class MessageQueueException : System::Runtime::InteropServices::ExternalException
[System.Serializable]
public class MessageQueueException : System.Runtime.InteropServices.ExternalException
type MessageQueueException = class
    inherit ExternalException
Public Class MessageQueueException
Inherits ExternalException
Наследование
Атрибуты

Примеры

#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 классом, создаются внутренними ошибками в очереди сообщений, которые должны обрабатываться кодом.Exceptions associated with the MessageQueueException class are generated by internal errors within Message Queuing that should be dealt with through your code.

Каждое исключение состоит из кода ошибки и текстовой строки, описывающей источник ошибки.Every exception consists of an error code and a text string that describes the source of the error. Список этих MessageQueueErrorCode кодов ошибок и их описание см. в классе.See the MessageQueueErrorCode class for a list of these error codes and their descriptions.

Если объект MessageQueue открывает очередь, параметр sharedModeDenyReceive которой имеет значение true, любой объект MessageQueue, который в последующем попытается прочитать данные из очереди, создаст объект MessageQueueException по причине нарушения общего доступа.If a MessageQueue opens a queue with the sharedModeDenyReceive parameter set to true, any MessageQueue that subsequently tries to read from the queue generates a MessageQueueException exception because of a sharing violation. Такое же исключение создается также в том случае, если MessageQueue пытается получить монопольный доступ к очереди, в то время как другой объект MessageQueue уже получил совмещаемый доступ к очереди.The same exception is thrown if a MessageQueue tries to access the queue in exclusive mode while another MessageQueue already has nonexclusive access to the queue.

Тег предупреждения не поддерживается!!!!alert tag is not supported!!!!
MessageQueueTransactionподдерживает потоковую подразделение.MessageQueueTransaction is threading-apartment-aware. Visual Basic устанавливает состояние основного потока в STA, поэтому необходимо MTAThreadAttribute применить в Main подподпрограмме.Visual Basic sets the state of the main thread to STA, so you must apply the MTAThreadAttribute in the Main subroutine. В противном случае при отправке транзакционного сообщения с помощью другого потока создастся исключение MessageQueueException.Otherwise, sending a transactional message using another thread throws a MessageQueueException exception.

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

MessageQueueException(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр класса MessageQueueException с сериализованными данными.Initializes a new instance of the MessageQueueException class with serialized data.

Свойства

Data

Возвращает коллекцию пар ключ/значение, предоставляющие дополнительные сведения об исключении, определяемые пользователем.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Унаследовано от Exception)
ErrorCode

Возвращает HRESULT ошибки.Gets the HRESULT of the error.

(Унаследовано от ExternalException)
HelpLink

Получает или задает ссылку на файл справки, связанный с этим исключением.Gets or sets a link to the help file associated with this exception.

(Унаследовано от Exception)
HResult

Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Унаследовано от Exception)
InnerException

Возвращает экземпляр класса Exception, который вызвал текущее исключение.Gets the Exception instance that caused the current exception.

(Унаследовано от Exception)
Message

Получает значение, описывающее ошибку Message Queuing.Gets a value that describes the Message Queuing error.

MessageQueueErrorCode

Получает значение, показывающее код ошибки, связанной с данным исключением.Gets a value that indicates the error code associated with this exception.

Source

Возвращает или задает имя приложения или объекта, вызывавшего ошибку.Gets or sets the name of the application or the object that causes the error.

(Унаследовано от Exception)
StackTrace

Получает строковое представление непосредственных кадров в стеке вызова.Gets a string representation of the immediate frames on the call stack.

(Унаследовано от Exception)
TargetSite

Возвращает метод, создавший текущее исключение.Gets the method that throws the current exception.

(Унаследовано от Exception)

Методы

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetBaseException()

При переопределении в производном классе возвращает исключение Exception, которое является корневой причиной одного или нескольких последующих исключений.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Унаследовано от Exception)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)

Заполняет объект сведений о сериализации данными, необходимыми для сериализации MessageQueueException.Populates a serialization information object with the data needed to serialize the MessageQueueException.

GetType()

Возвращает тип среды выполнения текущего экземпляра.Gets the runtime type of the current instance.

(Унаследовано от Exception)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, содержащую значение HRESULT ошибки.Returns a string that contains the HRESULT of the error.

(Унаследовано от ExternalException)

События

SerializeObjectState

Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Унаследовано от Exception)

Применяется к

Дополнительно