MessageQueue.Exists(String) Metoda

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

Určuje, zda fronta služby Řízení front zpráv existuje na zadané cestě.

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

Parametry

path

String

Umístění fronty, které chcete najít.

Návraty

Boolean

truepokud existuje fronta se zadanou cestou; v opačném případě . false

Výjimky

ArgumentException

Syntaxe path není platná.

MessageQueueException

Při přístupu k metodě služby Řízení front zpráv došlo k chybě.

-nebo-

Metoda Exists(String) se volá ve vzdálené privátní frontě.

InvalidOperationException

Aplikace použila syntaxi názvu formátu při ověřování existence fronty.

Příklady

Následující příklad kódu ověří, jestli fronta služby Řízení front zpráv existuje, a pak ji odstraní.

#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

Poznámky

Metoda Exists(String) určuje, zda fronta služby Řízení front zpráv existuje na zadané cestě. Neexistuje žádná metoda, která by určila, zda existuje fronta se zadaným názvem formátu. Další informace o syntaxi názvu formátu a dalších formulářích syntaxe cesty najdete ve Path vlastnosti .)

Exists(String) je nákladná operace. Používejte ho pouze v případě, že je to nezbytné v rámci aplikace.

Poznámka

Metoda Exists(String) nepodporuje předponu FormatName .

Syntaxe parametru path závisí na typu fronty, jak je znázorněno v následující tabulce.

Typ fronty	Syntax
Veřejná fronta	MachineName\QueueName

Exists(String) nelze volat k ověření existence vzdálené privátní fronty.

Další syntaxi najdete v Path vlastnosti .

Alternativně můžete použít Label k popisu cesty fronty.

Reference	Syntax
Popisek	Popisek:[ label ]

Následující tabulka ukazuje, zda je tato metoda k dispozici v různých režimech pracovní skupiny.

Režim pracovní skupiny	K dispozici.
Místní počítač	Yes
Název místního počítače a přímého formátu	No
Vzdálený počítač	No
Název vzdáleného počítače a přímého formátu	No

Viz také

• Path