MessageQueueException Classe

Définition

Espace de noms:

System.Messaging

Assembly:

System.Messaging.dll

Exception levée quand une erreur interne Microsoft Message Queuing se produit.

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

Héritage

Object

Exception

SystemException

ExternalException

MessageQueueException

Attributs

SerializableAttribute

Implémente

ISerializable

Exemples

#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

Remarques

Les exceptions associées à la MessageQueueException classe sont générées par des erreurs internes dans Message Queuing qui doivent être traitées par le biais de votre code.

Chaque exception se compose d’un code d’erreur et d’une chaîne de texte qui décrit la source de l’erreur. Consultez la MessageQueueErrorCode classe pour obtenir la liste de ces codes d’erreur et leurs descriptions.

Si MessageQueue ouvre une file d'attente avec la valeur du paramètre sharedModeDenyReceive égale à true, tout MessageQueue qui tente par la suite une opération de lecture à partir de la file d'attente génère une exception MessageQueueException à cause d'une violation de partage. La même exception est levée si MessageQueue tente d'accéder à la file d'attente en mode exclusif, alors qu'un autre MessageQueue dispose déjà d'un droit d'accès non exclusif sur la file d'attente.

la balise d’alerte n’est pas prise en charge !!!
MessageQueueTransaction prend en charge le threading-apartment. Visual Basic définit l’état du thread main sur STA, vous devez donc appliquer dans MTAThreadAttribute la Main sous-routine. Sinon, l'envoi d'un message transactionnel qui utilise un autre thread lève une exception MessageQueueException.

Constructeurs

MessageQueueException(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe MessageQueueException avec des données sérialisées.

Propriétés

Data	Obtient une collection de paires clé/valeur qui fournissent des informations définies par l'utilisateur supplémentaires sur l'exception. (Hérité de Exception)
ErrorCode	Obtient le HRESULT de l’erreur. (Hérité de ExternalException)
HelpLink	Obtient ou définit un lien vers le fichier d'aide associé à cette exception. (Hérité de Exception)
HResult	Obtient ou définit HRESULT, valeur numérique codée qui est assignée à une exception spécifique. (Hérité de Exception)
InnerException	Obtient l'instance Exception qui a provoqué l'exception actuelle. (Hérité de Exception)
Message	Obtient une valeur qui décrit l'erreur Message Queuing.
MessageQueueErrorCode	Obtient une valeur qui indique le code d'erreur associé à cette exception.
Source	Obtient ou définit le nom de l'application ou de l'objet qui est à l'origine de l'erreur. (Hérité de Exception)
StackTrace	Obtient une représentation sous forme de chaîne des frames immédiats sur la pile des appels. (Hérité de Exception)
TargetSite	Obtient la méthode qui lève l'exception actuelle. (Hérité de Exception)

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetBaseException()	En cas de substitution dans une classe dérivée, retourne la Exception qui est à l'origine d'une ou de plusieurs exceptions ultérieures. (Hérité de Exception)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetObjectData(SerializationInfo, StreamingContext)	Remplit un objet d’informations de sérialisation avec les données nécessaires pour sérialiser MessageQueueException.
GetType()	Obtient le type au moment de l'exécution de l'instance actuelle. (Hérité de Exception)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui contient le HRESULT de l'erreur. (Hérité de ExternalException)

Événements

SerializeObjectState

Se produit quand une exception est sérialisée pour créer un objet d'état d'exception qui contient des données sérialisées concernant l'exception. (Hérité de Exception)

Voir aussi

• MessageQueueErrorCode
• MessageQueue
• Message