MessageQueue.Delete(String) Methode

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Löschte eine Warteschlange auf einem Message Queuing-Server.

public:
 static void Delete(System::String ^ path);

public static void Delete (string path);

static member Delete : string -> unit

Public Shared Sub Delete (path As String)

Parameter

path

String

Der Speicherort der zu löschenden Warteschlange.

Ausnahmen

ArgumentException

Der path-Parameter ist null oder eine leere Zeichenfolge ("").

MessageQueueException

Die Syntax für den path-Parameter ist ungültig.

- oder -

Fehler beim Zugriff auf eine Message Queuing-Methode.

Beispiele

Im folgenden Codebeispiel wird eine Message Queuing-Warteschlange gelöscht, sofern sie vorhanden ist.

#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

Hinweise

Die Syntax für den path Parameter hängt vom Typ der Warteschlange ab.

Warteschlangentyp	Syntax
Öffentliche Warteschlange	MachineName\QueueName
Private Warteschlange	MachineName\Private$\QueueName

Weitere Syntax finden Sie in der Path -Eigenschaft.

Alternativ können Sie den FormatName Oder Label verwenden, um den Warteschlangenpfad zu beschreiben.

Verweis	Syntax
Formatname	FormatName:[ Formatname ]
Bezeichnung	Bezeichnung:[ Bezeichnung ]

Die folgende Tabelle zeigt, ob diese Methode in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus	Verfügbar
Lokalem Computer	Ja
Name des lokalen Computers und des direkten Formats	Ja
Remotecomputer	Nein
Name des Remotecomputers und des direkten Formats	Nein

Weitere Informationen

• Close()
• Path