MessageQueue.Exists(String) Méthode

Définition

Espace de noms:

System.Messaging

Assembly:

System.Messaging.dll

Détermine si une file d’attente Message Queuing existe au niveau du chemin d’accès spécifié.

public:
 static bool Exists(System::String ^ path);

public static bool Exists(string path);

static member Exists : string -> bool

Public Shared Function Exists (path As String) As Boolean

Paramètres

path

String

Emplacement de la file d’attente à rechercher.

Retours

Boolean

true si une file d’attente avec le chemin spécifié existe ; sinon, false.

Exceptions

ArgumentException

La path syntaxe n’est pas valide.

MessageQueueException

Une erreur s’est produite lors de l’accès à une méthode Message Queuing.

- ou -

La Exists(String) méthode est appelée sur une file d’attente privée distante

InvalidOperationException

La syntaxe du nom de format utilisé par l’application lors de la vérification de l’existence de la file d’attente.

Exemples

L’exemple de code suivant vérifie si une file d’attente Message Queuing existe, puis la supprime.

#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

La Exists(String) méthode détermine si une file d’attente Message Queuing existe à un chemin d’accès spécifié. Aucune méthode n’existe pour déterminer si une file d’attente avec un nom de format spécifié existe. Pour plus d’informations sur la syntaxe du nom de format et d’autres formulaires de syntaxe de chemin d’accès, consultez la Path propriété.)

Exists(String) est une opération coûteuse. Utilisez-le uniquement lorsqu’il est nécessaire dans l’application.

Note

La Exists(String) méthode ne prend pas en charge le FormatName préfixe.

La syntaxe du path paramètre dépend du type de file d’attente, comme indiqué dans le tableau suivant.

Type de file d'attente	Syntaxe
File d’attente publique	MachineName\QueueName

Exists(String) ne peut pas être appelé pour vérifier l’existence d’une file d’attente privée distante.

Pour plus de syntaxe, consultez la Path propriété.

Vous pouvez également utiliser la Label méthode pour décrire le chemin d’accès de la file d’attente.

Référence	Syntaxe
Étiquette	Label :[ label ]

Le tableau suivant indique si cette méthode est disponible dans différents modes de groupe de travail.

Mode groupe de travail	Disponible
Ordinateur local	Oui
Ordinateur local et nom de format direct	Non
Ordinateur distant	Non
Ordinateur distant et nom de format direct	Non

Voir aussi

• Path