MessageQueue.Exists(String) Método

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

Parâmetros

Devoluções

true se existir uma fila com o caminho especificado; caso contrário, false.

Exceções

Exemplos

O exemplo de código seguinte verifica se existe uma fila de Fila de Mensagens e depois elimina-a.

#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

Observações

O Exists(String) método determina se existe uma fila de Fila de Mensagens num caminho especificado. Não existe método para determinar se existe uma fila com um nome de formato especificado. Para mais informações sobre a sintaxe do nome do formato e outras formas de sintaxe de caminho, consulte a Path propriedade.)

Exists(String) é uma operação dispendiosa. Use-o apenas quando for necessário na aplicação.

A sintaxe do path parâmetro depende do tipo de fila, como mostrado na tabela seguinte.

Exists(String) não pode ser chamado para verificar a existência de uma fila privada remota.

Para mais sintaxe, veja a Path propriedade.

Alternativamente, pode usar o Label para descrever o caminho da fila.

A tabela seguinte mostra se este método está disponível em vários modos de Grupo de Trabalho.

Ver também

• Path