MessageQueueException Classe

Définition

Espace de noms:: System.Messaging

Assembly:: System.Messaging.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Exception levée si 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 classe pour obtenir la MessageQueueErrorCode liste de ces codes d’erreur et leurs descriptions.

Si une MessageQueue file d’attente ouvre une file d’attente avec le sharedModeDenyReceive paramètre défini sur true, tout MessageQueue élément qui tente par la suite de lire à partir de la file d’attente génère une MessageQueueException exception en raison d’une violation de partage. La même exception est levée si une tentative d’accès MessageQueue à la file d’attente en mode exclusif tandis qu’une autre MessageQueue a déjà un accès non-cluster à la file d’attente.

la balise d’alerte n’est pas prise en charge !!!MessageQueueTransaction est threading-apartment-aware. Visual Basic définit l’état du thread STAprincipal sur ; vous devez donc appliquer le MTAThreadAttributeMain sous-routine. Sinon, l’envoi d’un message transactionnel à l’aide d’un autre thread lève une MessageQueueException exception.

Constructeurs

Nom	Description
MessageQueueException(SerializationInfo, StreamingContext)	Initialise une nouvelle instance de la MessageQueueException classe avec des données sérialisées.

Propriétés

Nom	Description
Data	Obtient une collection de paires clé/valeur qui fournissent des informations supplémentaires définies par l’utilisateur sur l’exception. (Hérité de Exception)
ErrorCode	Obtient l’erreur `HRESULT` . (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 affecté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 provoque l’erreur. (Hérité de Exception)
StackTrace	Obtient une représentation sous forme de chaîne des images immédiates 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

Nom	Description
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 cause racine d’une ou plusieurs exceptions ultérieures. (Hérité de Exception)
GetHashCode()	Sert 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 le MessageQueueException.
GetType()	Obtient le type d’exécution de l’instance actuelle. (Hérité de Exception)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui contient le HRESULT de l’erreur. (Hérité de ExternalException)

Événements

Nom	Description
SerializeObjectState	Obsolète. Se produit lorsqu’une exception est sérialisée pour créer un objet d’état d’exception qui contient des données sérialisées sur l’exception. (Hérité de Exception)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?