MessageQueue.Exists(String) Yöntem

Tanım

Ad Alanı:

System.Messaging

Bütünleştirilmiş Kod:

System.Messaging.dll

Belirtilen yolda bir Message Queuing kuyruğu olup olmadığını belirler.

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

Parametreler

path

String

Bulunacak kuyruğun konumu.

Döndürülenler

Boolean

true belirtilen yola sahip bir kuyruk varsa; aksi takdirde , false.

Özel durumlar

ArgumentException

Söz path dizimi geçerli değil.

MessageQueueException

Message Queuing yöntemine erişilirken bir hata oluştu.

-veya-

Exists(String) yöntemi uzak bir özel kuyrukta çağrılır

InvalidOperationException

Uygulama, kuyruk varlığını doğrularken biçim adı söz dizimini kullandı.

Örnekler

Aşağıdaki kod örneği bir Message Queuing kuyruğunun mevcut olup olmadığını doğrular ve ardından bu kuyruğu siler.

#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

Açıklamalar

yöntemi, Exists(String) bir Message Queuing kuyruğunun belirtilen yolda var olup olmadığını belirler. Belirtilen biçim adına sahip bir kuyruğun mevcut olup olmadığını belirlemek için bir yöntem yok. Biçim adı söz dizimi ve diğer yol söz dizimi formları hakkında daha fazla bilgi için özelliğine Path bakın.)

Exists(String) pahalı bir işlemdir. Yalnızca uygulama içinde gerekli olduğunda kullanın.

Not

Exists(String) yöntemi ön eki desteklemezFormatName.

Parametrenin path söz dizimi, aşağıdaki tabloda gösterildiği gibi kuyruğun türüne bağlıdır.

Kuyruk türü	Syntax
Genel kuyruk	MachineName\QueueName

Exists(String) uzak özel kuyruğun varlığını doğrulamak için çağrılamaz.

Daha fazla söz dizimi için özelliğine Path bakın.

Alternatif olarak, kuyruk yolunu açıklamak için kullanabilirsiniz Label .

Başvuru	Syntax
Etiketle	Etiket:[ label ]

Aşağıdaki tabloda bu yöntemin çeşitli Çalışma Grubu modlarında kullanılabilir olup olmadığı gösterilmektedir.

Çalışma grubu modu	Kullanılabilir
Yerel bilgisayar	Yes
Yerel bilgisayar ve doğrudan biçim adı	No
Uzak bilgisayar	No
Uzak bilgisayar ve doğrudan biçim adı	No

Ayrıca bkz.

• Path