MessageQueue.Delete(String) Método

Definición

Espacio de nombres:

System.Messaging

Ensamblado:

System.Messaging.dll

Elimina una cola en un servidor de Message Queuing.

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)

Parámetros

path

String

Ubicación de la cola que se va a eliminar.

Excepciones

ArgumentException

El parámetro path es null o una cadena vacía ("").

MessageQueueException

La sintaxis del parámetro path no es válida.

o bien

Error al obtener acceso a un método de Message Queuing.

Ejemplos

En el ejemplo de código siguiente se elimina una cola de Message Queuing, si existe.

#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

Comentarios

La sintaxis del path parámetro depende del tipo de cola.

Tipo de cola	Syntax
Cola pública	MachineName\QueueName
Cola privada	MachineName\Private$\QueueName

Para obtener más sintaxis, consulte la Path propiedad .

Como alternativa, puede usar o FormatNameLabel para describir la ruta de acceso de la cola.

Referencia	Sintaxis
Nombre de formato	FormatName:[ format name ]
Etiqueta	Label:[ label ]

En la tabla siguiente se muestra si este método está disponible en varios modos de grupo de trabajo.

Modo de grupo de trabajo	Disponible
Equipo local	Sí
Equipo local y nombre de formato directo	Sí
Equipo remoto	No
Equipo remoto y nombre de formato directo	No

Consulte también

• Close()
• Path