MessageQueueException Classe

Definizione

Spazio dei nomi:

System.Messaging

Assembly:

System.Messaging.dll

Eccezione generata se si verifica un errore interno di Accodamento messaggi 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

Ereditarietà

Object

Exception

SystemException

ExternalException

MessageQueueException

Attributi

SerializableAttribute

Implementazioni

ISerializable

Esempio

#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

Commenti

Le eccezioni associate alla MessageQueueException classe vengono generate da errori interni all'interno di Accodamento messaggi che devono essere gestite tramite il codice.

Ogni eccezione è costituita da un codice di errore e da una stringa di testo che descrive l'origine dell'errore. Vedere la MessageQueueErrorCode classe per un elenco di questi codici di errore e le relative descrizioni.

Se un MessageQueue oggetto apre una coda con il sharedModeDenyReceive parametro impostato su true, qualsiasi MessageQueue oggetto che successivamente tenta di leggere dalla coda genera un'eccezione MessageQueueException a causa di una violazione di condivisione. La stessa eccezione viene generata se un MessageQueue oggetto tenta di accedere alla coda in modalità esclusiva, mentre un altro MessageQueue ha già accesso non esclusivo alla coda.

il tag di avviso non è supportato!!!MessageQueueTransaction è in grado di threading-apartment-aware. Visual Basic imposta lo stato del thread principale su STA, pertanto è necessario applicare nella MTAThreadAttributeMain subroutine. In caso contrario, l'invio di un messaggio transazionale tramite un altro thread genera un'eccezione MessageQueueException .

Costruttori

Nome	Descrizione
MessageQueueException(SerializationInfo, StreamingContext)	Inizializza una nuova istanza della MessageQueueException classe con dati serializzati.

Proprietà

Nome	Descrizione
Data	Ottiene una raccolta di coppie chiave/valore che forniscono informazioni aggiuntive definite dall'utente sull'eccezione. (Ereditato da Exception)
ErrorCode	Ottiene l'oggetto HRESULT dell'errore. (Ereditato da ExternalException)
HelpLink	Ottiene o imposta un collegamento al file della Guida associato a questa eccezione. (Ereditato da Exception)
HResult	Ottiene o imposta HRESULT, valore numerico codificato assegnato a un'eccezione specifica. (Ereditato da Exception)
InnerException	Ottiene l'istanza Exception che ha causato l'eccezione corrente. (Ereditato da Exception)
Message	Ottiene un valore che descrive l'errore di accodamento messaggi.
MessageQueueErrorCode	Ottiene un valore che indica il codice di errore associato a questa eccezione.
Source	Ottiene o imposta il nome dell'applicazione o dell'oggetto che causa l'errore. (Ereditato da Exception)
StackTrace	Ottiene una rappresentazione di stringa dei fotogrammi immediati nello stack di chiamate. (Ereditato da Exception)
TargetSite	Ottiene il metodo che genera l'eccezione corrente. (Ereditato da Exception)

Metodi

Nome	Descrizione
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetBaseException()	Quando sottoposto a override in una classe derivata, restituisce l'oggetto Exception che rappresenta la causa radice di una o più eccezioni successive. (Ereditato da Exception)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetObjectData(SerializationInfo, StreamingContext)	Popola un oggetto informazioni di serializzazione con i dati necessari per serializzare l'oggetto MessageQueueException.
GetType()	Ottiene il tipo di runtime dell'istanza corrente. (Ereditato da Exception)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
ToString()	Restituisce una stringa che contiene il valore HRESULT dell'errore. (Ereditato da ExternalException)

Eventi

Nome	Descrizione
SerializeObjectState	Si verifica quando viene serializzata un'eccezione per creare un oggetto stato dell'eccezione contenente dati serializzati sull'eccezione. (Ereditato da Exception)

Vedi anche

• MessageQueueErrorCode
• MessageQueue
• Message