Partager via


MessageQueue.Exists(String) Méthode

Définition

Détermine si une file d'attente Message Queuing existe dans le 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

true si une file d'attente existe dans le chemin d'accès spécifié ; sinon, false.

Exceptions

La syntaxe path n'est pas valide.

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

- ou -

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

L'application a utilisé une syntaxe de nom de format pour vérifier 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 spécifié. Il n’existe aucune méthode permettant de déterminer si une file d’attente avec un nom de format spécifié existe. Pour plus d’informations sur la syntaxe de nom de format et d’autres formes de syntaxe de chemin d’accès, consultez la Path propriété .)

Exists(String) est une opération coûteuse. Utilisez-la uniquement lorsque cela est nécessaire dans l’application.

Notes

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

La syntaxe du paramètre dépend du path 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 pour décrire le Label chemin de file d’attente.

Informations de référence Syntaxe
Etiquette Étiquette : [ 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

S’applique à

Voir aussi