MessageQueue.Exists(String) Méthode

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

Retours

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

Exceptions

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.

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

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.

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

S’applique à

Voir aussi

• Path