MessageQueue.Exists(String) Metodo

Definizione

Spazio dei nomi:

System.Messaging

Assembly:

System.Messaging.dll

Determina se una coda di Accodamento messaggi è presente nel percorso specificato.

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

Parametri

path

String

Posizione della coda da trovare.

Restituisce

Boolean

true se esiste una coda con il percorso specificato; in caso contrario, false.

Eccezioni

ArgumentException

La sintassi di path non è valida.

MessageQueueException

Si è verificato un errore durante l'accesso a un metodo di Accodamento messaggi.

-oppure-

Il metodo Exists(String) viene chiamato su una coda privata remota.

InvalidOperationException

Nell'applicazione è stata utilizzata la sintassi dei nomi di formato durante la verifica dell'esistenza della coda.

Esempio

Nell'esempio di codice seguente viene verificato se esiste una coda accodamento messaggi e quindi la elimina.

#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

Commenti

Il Exists(String) metodo determina se esiste una coda di accodamento messaggi in un percorso specificato. Non esiste alcun metodo per determinare se esiste una coda con un nome di formato specificato. Per altre informazioni sulla sintassi del nome di formato e su altri moduli di sintassi del percorso, vedere la Path proprietà .

Exists(String) è un'operazione costosa. Usarlo solo quando è necessario all'interno dell'applicazione.

Nota

Il Exists(String) metodo non supporta il FormatName prefisso.

La sintassi per il path parametro dipende dal tipo di coda, come illustrato nella tabella seguente.

Tipo di coda	Sintassi
Coda pubblica	MachineName\QueueName

Exists(String) non può essere chiamato per verificare l'esistenza di una coda privata remota.

Per altre sintassi, vedere la Path proprietà .

In alternativa, è possibile usare per Label descrivere il percorso della coda.

Riferimento	Sintassi
Etichetta	Label:[ label ]

Nella tabella seguente viene illustrato se questo metodo è disponibile in varie modalità gruppo di lavoro.

Modalità gruppo di lavoro	Disponibile
Computer locale	Sì
Computer locale e nome del formato diretto	No
Computer remoto	No
Nome del formato diretto e del computer remoto	No

Vedi anche

• Path