Acknowledgment Acknowledgment Acknowledgment Acknowledgment Enum

定義

指定訊息傳遞的結果。Specifies the result of an attempted message delivery.

public enum class Acknowledgment
[System.Serializable]
public enum Acknowledgment
type Acknowledgment = 
Public Enum Acknowledgment
繼承
AcknowledgmentAcknowledgmentAcknowledgmentAcknowledgment
屬性

欄位

AccessDenied AccessDenied AccessDenied AccessDenied 32772

負抵達通知表示傳送端應用程式不具有傳送訊息到目的佇列的必要權限。A negative arrival acknowledgment indicating that the sending application does not have the necessary rights to send a message to the destination queue.

BadDestinationQueue BadDestinationQueue BadDestinationQueue BadDestinationQueue 32768

負抵達通知表示目的佇列無法供傳送端應用程式使用。A negative arrival acknowledgment indicating that the destination queue is not available to the sending application.

BadEncryption BadEncryption BadEncryption BadEncryption 32775

負抵達通知表示目的佇列管理員無法將私用 (Private) 訊息解密。A negative arrival acknowledgment indicating that the destination queue manager could not decrypt a private message.

BadSignature BadSignature BadSignature BadSignature 32774

負抵達通知表示原始訊息的數位簽章無效且無法由訊息佇列驗證。A negative arrival acknowledgment indicating that the original message's digital signature is not valid and could not be authenticated by Message Queuing.

CouldNotEncrypt CouldNotEncrypt CouldNotEncrypt CouldNotEncrypt 32776

負抵達通知表示來源佇列管理員無法將私用訊息加密。A negative arrival acknowledgment indicating that the source queue manager could not encrypt a private message.

HopCountExceeded HopCountExceeded HopCountExceeded HopCountExceeded 32773

負抵達通知表示原始訊息的躍點數目 (表示中繼伺服器的數目) 已超過。A negative arrival acknowledgment indicating that the original message's hop count (which indicates the number of intermediate servers) was exceeded. 最大躍點計數 15 由訊息佇列設定,且為不可變。The maximum hop count, 15, is set by Message Queuing and is immutable.

None None None None 0

訊息並不是一個通知訊息。The message is not an acknowledgment message.

NotTransactionalMessage NotTransactionalMessage NotTransactionalMessage NotTransactionalMessage 32778

負抵達通知表示不可交易的訊息已傳送至可交易佇列。A negative arrival acknowledgment indicating that a non-transactional message was sent to a transactional queue.

NotTransactionalQueue NotTransactionalQueue NotTransactionalQueue NotTransactionalQueue 32777

負抵達通知表示可交易訊息已傳送至非交易佇列。A negative arrival acknowledgment indicating that a transactional message was sent to a non-transactional queue.

Purged Purged Purged Purged 32769

負抵達通知表示訊息在抵達它的目的佇列之前已被清除。A negative arrival acknowledgment indicating that the message was purged before reaching its destination queue.

QueueDeleted QueueDeleted QueueDeleted QueueDeleted 49152

負抵達通知表示在可讀取訊息之前佇列已被刪除。A negative read acknowledgment indicating that the queue was deleted before the message could be read.

QueueExceedMaximumSize QueueExceedMaximumSize QueueExceedMaximumSize QueueExceedMaximumSize 32771

負抵達通知表示因為目的佇列已滿而無法傳遞原始訊息。A negative arrival acknowledgment indicating that the original message was not delivered because its destination queue is full.

QueuePurged QueuePurged QueuePurged QueuePurged 49153

負讀取通知表示在可讀取訊息之前佇列已被清除。A negative read acknowledgment indicating that the queue was purged before the message could be read.

ReachQueue ReachQueue ReachQueue ReachQueue 2

正抵達通知表示原始訊息已抵達它的目的佇列。A positive arrival acknowledgment indicating that the original message reached its destination queue.

ReachQueueTimeout ReachQueueTimeout ReachQueueTimeout ReachQueueTimeout 32770

負抵達通知表示在原始訊息抵達目的佇列之前,抵達佇列時間計時器或接收時間計時器已到期。A negative arrival acknowledgment indicating that the time-to-reach-queue or time-to-be-received timer expired before the original message could reach the destination queue.

Receive Receive Receive Receive 16384

正讀取通知表示原始訊息已由接收端應用程式接收。A positive read acknowledgment indicating that the original message was received by the receiving application.

ReceiveTimeout ReceiveTimeout ReceiveTimeout ReceiveTimeout 49154

負讀取通知表示原始訊息在它的接收時間計時器到期前,佇列尚未收到該原始訊息。A negative read acknowledgment indicating that the original message was not received from the queue before its time-to-be-received timer expired.

範例

下列程式碼範例會在佇列中傳送和接收包含訂單的訊息。The following code example sends and receives a message containing an order to and from a queue. 它會在原始訊息到達或從佇列抓取時, 特別要求正面通知。It specifically requests a positive acknowledgment when the original message reaches or is retrieved from the queue.

#using <system.dll>
#using <system.messaging.dll>

using namespace System;
using namespace System::Messaging;
ref class MyNewQueue
{
public:
   static void CreateQueue( String^ queuePath )
   {
      try
      {
         if (  !MessageQueue::Exists( queuePath ) )
         {
            MessageQueue::Create( queuePath );
         }
         else
         {
            Console::WriteLine(  "{0} already exists.", queuePath );
         }
      }
      catch ( MessageQueueException^ e ) 
      {
         Console::WriteLine( e->Message );
      }

   }

   void SendMessage()
   {
      // Connect to a queue on the local computer.
      MessageQueue^ myQueue = gcnew MessageQueue( ".\\myQueue" );

      // Create a new message.
      Message^ myMessage = gcnew Message( "Original Message" );
      myMessage->AdministrationQueue = gcnew MessageQueue( ".\\myAdministrationQueue" );
      myMessage->AcknowledgeType = (AcknowledgeTypes)(AcknowledgeTypes::PositiveReceive | AcknowledgeTypes::PositiveArrival);

      // Send the Order to the queue.
      myQueue->Send( myMessage );
      return;
   }

   String^ ReceiveMessage()
   {
      // Connect to the a queue on the local computer.
      MessageQueue^ myQueue = gcnew MessageQueue( ".\\myQueue" );
      myQueue->MessageReadPropertyFilter->CorrelationId = true;
      array<Type^>^p = gcnew array<Type^>(1);
      p[ 0 ] = String::typeid;
      myQueue->Formatter = gcnew XmlMessageFormatter( p );
      String^ returnString = nullptr;
      try
      {
         // Receive and format the message. 
         Message^ myMessage = myQueue->Receive();

         // Display message information.
         Console::WriteLine( "____________________________________________" );
         Console::WriteLine( "Original message information--" );
         Console::WriteLine( "Body: {0}", myMessage->Body );
         Console::WriteLine( "Id: {0}", myMessage->Id );
         Console::WriteLine( "____________________________________________" );
         returnString = myMessage->Id;
      }
      catch ( MessageQueueException^ ) 
      {
         // Handle Message Queuing exceptions.
      }
      // Handle invalid serialization format.
      catch ( InvalidOperationException^ e ) 
      {
         Console::WriteLine( e->Message );
      }

      // Catch other exceptions as necessary.
      return returnString;
   }

   void ReceiveAcknowledgment( String^ messageId, String^ queuePath )
   {
      bool found = false;
      MessageQueue^ queue = gcnew MessageQueue( queuePath );
      queue->MessageReadPropertyFilter->CorrelationId = true;
      queue->MessageReadPropertyFilter->Acknowledgment = true;
      try
      {
         while ( queue->PeekByCorrelationId( messageId ) != nullptr )
         {
            Message^ myAcknowledgmentMessage = queue->ReceiveByCorrelationId( messageId );

            // Output acknowledgment message information. The correlation Id is identical
            // to the id of the original message.
            Console::WriteLine( "Acknowledgment Message Information--" );
            Console::WriteLine( "Correlation Id: {0}", myAcknowledgmentMessage->CorrelationId );
            Console::WriteLine( "Id: {0}", myAcknowledgmentMessage->Id );
            Console::WriteLine( "Acknowledgment Type: {0}", myAcknowledgmentMessage->Acknowledgment );
            Console::WriteLine( "____________________________________________" );
            found = true;
         }
      }
      catch ( InvalidOperationException^ e ) 
      {
         // This exception would be thrown if there is no (further) acknowledgment message
         // with the specified correlation Id. Only output a message if there are no messages;
         // not if the loop has found at least one.
         if ( found == false )
         {
            Console::WriteLine( e->Message );
         }

         // Handle other causes of invalid operation exception.
      }

   }

};

int main()
{
   // Create a new instance of the class.
   MyNewQueue^ myNewQueue = gcnew MyNewQueue;

   // Create new queues.
   MyNewQueue::CreateQueue( ".\\myQueue" );
   MyNewQueue::CreateQueue( ".\\myAdministrationQueue" );

   // Send messages to a queue.
   myNewQueue->SendMessage();

   // Receive messages from a queue.
   String^ messageId = myNewQueue->ReceiveMessage();

   // Receive acknowledgment message.
   if ( messageId != nullptr )
   {
      myNewQueue->ReceiveAcknowledgment( messageId, ".\\myAdministrationQueue" );
   }

   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 sends and receives a message from
		// a queue.
		//**************************************************

		public static void Main()
		{
			// Create a new instance of the class.
			MyNewQueue myNewQueue = new MyNewQueue();

			// Create new queues.
			CreateQueue(".\\myQueue");
			CreateQueue(".\\myAdministrationQueue");

			// Send messages to a queue.
			myNewQueue.SendMessage();

			// Receive messages from a queue.
			string messageId = myNewQueue.ReceiveMessage(); 

			// Receive acknowledgment message.
			if(messageId != null)
			{
				myNewQueue.ReceiveAcknowledgment(messageId, ".\\myAdministrationQueue");
			}

			return;
		}

		//**************************************************
		// Creates a new queue.
		//**************************************************

		public static void CreateQueue(string queuePath)
		{
			try	
			{
				if(!MessageQueue.Exists(queuePath))
				{
					MessageQueue.Create(queuePath);
				}
				else
				{
					Console.WriteLine(queuePath + " already exists.");
				}
			}
			catch (MessageQueueException e)
			{
				Console.WriteLine(e.Message);
			}
			
		}


		//**************************************************
		// Sends a string message to a queue.
		//**************************************************
		
		public void SendMessage()
		{

			// Connect to a queue on the local computer.
			MessageQueue myQueue = new MessageQueue(".\\myQueue");

			// Create a new message.
			Message myMessage = new Message("Original Message"); 

			myMessage.AdministrationQueue = new MessageQueue(".\\myAdministrationQueue");
			myMessage.AcknowledgeType = AcknowledgeTypes.PositiveReceive | AcknowledgeTypes.PositiveArrival;

			// Send the Order to the queue.
			myQueue.Send(myMessage);

			return;
		}


		//**************************************************
		// Receives a message containing an Order.
		//**************************************************
		
		public  string ReceiveMessage()
		{
			// Connect to the a queue on the local computer.
			MessageQueue myQueue = new MessageQueue(".\\myQueue");

			myQueue.MessageReadPropertyFilter.CorrelationId = true;


			// Set the formatter to indicate body contains an Order.
			myQueue.Formatter = new XmlMessageFormatter(new Type[]
				{typeof(string)});

			string returnString = null;
			
			try
			{
				// Receive and format the message. 
				Message myMessage =	myQueue.Receive(); 


				// Display message information.
				Console.WriteLine("____________________________________________");
				Console.WriteLine("Original message information--");
				Console.WriteLine("Body: " +myMessage.Body.ToString());
				Console.WriteLine("Id: " + myMessage.Id.ToString());
				Console.WriteLine("____________________________________________");

				returnString =  myMessage.Id;
				
			}
			
			catch (MessageQueueException)
			{
				// Handle Message Queuing exceptions.
			}

			// Handle invalid serialization format.
			catch (InvalidOperationException e)
			{
				Console.WriteLine(e.Message);
			}
			
			// Catch other exceptions as necessary.

			return returnString;
		}

		//**************************************************
		// Receives a message containing an Order.
		//**************************************************
		
		public void ReceiveAcknowledgment(string messageId, string queuePath)
		{
			bool found = false;
			MessageQueue queue = new MessageQueue(queuePath);
			queue.MessageReadPropertyFilter.CorrelationId = true;
			queue.MessageReadPropertyFilter.Acknowledgment = true;

			try
			{
				while(queue.PeekByCorrelationId(messageId) != null)
				{
					Message myAcknowledgmentMessage = queue.ReceiveByCorrelationId(messageId);
			
					// Output acknowledgment message information. The correlation Id is identical
					// to the id of the original message.
					Console.WriteLine("Acknowledgment Message Information--");
					Console.WriteLine("Correlation Id: " + myAcknowledgmentMessage.CorrelationId.ToString());
					Console.WriteLine("Id: " + myAcknowledgmentMessage.Id.ToString());
					Console.WriteLine("Acknowledgment Type: " + myAcknowledgmentMessage.Acknowledgment.ToString());
					Console.WriteLine("____________________________________________");

					found = true;
				}
			}
			catch (InvalidOperationException e)
			{ 
				// This exception would be thrown if there is no (further) acknowledgment message
				// with the specified correlation Id. Only output a message if there are no messages;
				// not if the loop has found at least one.
				if(found == false)
				{	
					Console.WriteLine(e.Message);
				}

				// Handle other causes of invalid operation exception.
			}

		}
	}
}
Imports System.Messaging


' Provides a container class for the example.

Public Class MyNewQueue
   
   

   ' Provides an entry point into the application.       
   ' This example sends and receives a message from
   ' a queue.
      
   Public Shared Sub Main()
         ' Create a new instance of the class.
         Dim myNewQueue As New MyNewQueue()
         
         ' Create new queues.
         CreateQueue(".\myQueue")
         CreateQueue(".\myAdministrationQueue")
         
         ' Send messages to a queue.
         myNewQueue.SendMessage()
         
         ' Receive messages from a queue.
         Dim messageId As String = myNewQueue.ReceiveMessage()
         
         ' Receive acknowledgment message.
         If Not (messageId Is Nothing) Then
            myNewQueue.ReceiveAcknowledgment(messageId, ".\myAdministrationQueue")
         End If
         
         Return
   End Sub
      
      
      ' Creates a new queue.

   Public Shared Sub CreateQueue(queuePath As String)
         Try
            If Not MessageQueue.Exists(queuePath) Then
               MessageQueue.Create(queuePath)
            Else
               Console.WriteLine((queuePath + " already exists."))
            End If
         Catch e As MessageQueueException
            Console.WriteLine(e.Message)
         End Try
   End Sub
       
      
      
 
      ' Sends a string message to a queue.
 
   Public Sub SendMessage()
         
         ' Connect to a queue on the local computer.
         Dim myQueue As New MessageQueue(".\myQueue")
         
         ' Create a new message.
         Dim myMessage As New Message("Original Message")
         
         myMessage.AdministrationQueue = New MessageQueue(".\myAdministrationQueue")
         myMessage.AcknowledgeType = AcknowledgeTypes.PositiveReceive Or AcknowledgeTypes.PositiveArrival
         
         ' Send the Order to the queue.
         myQueue.Send(myMessage)
         
         Return
   End Sub
      
      
      
 
      ' Receives a message containing an Order.
 
   Public Function ReceiveMessage() As String
         ' Connect to the a queue on the local computer.
         Dim myQueue As New MessageQueue(".\myQueue")
         
         myQueue.MessageReadPropertyFilter.CorrelationId = True
         
         
         ' Set the formatter to indicate body contains an Order.
         myQueue.Formatter = New XmlMessageFormatter(New Type() {GetType(String)})
         
         Dim returnString As String = Nothing
         
         Try
            ' Receive and format the message. 
            Dim myMessage As Message = myQueue.Receive()
            
            
            ' Display message information.
            Console.WriteLine("____________________________________________")
            Console.WriteLine("Original message information--")
            Console.WriteLine(("Body: " + myMessage.Body.ToString()))
            Console.WriteLine(("Id: " + myMessage.Id.ToString()))
            Console.WriteLine("____________________________________________")
            
            returnString = myMessage.Id
         
         
                  
         ' Handle invalid serialization format.
         Catch e As InvalidOperationException
            Console.WriteLine(e.Message)
         End Try
         
         ' Catch other exceptions as necessary.
         Return returnString
   End Function 'ReceiveMessage
      
      
 
      ' Receives a message containing an Order.
 
   Public Sub ReceiveAcknowledgment(messageId As String, queuePath As String)
         Dim found As Boolean = False
         Dim queue As New MessageQueue(queuePath)
         queue.MessageReadPropertyFilter.CorrelationId = True
         queue.MessageReadPropertyFilter.Acknowledgment = True
         
         Try
            While Not (queue.PeekByCorrelationId(messageId) Is Nothing)
               Dim myAcknowledgmentMessage As Message = queue.ReceiveByCorrelationId(messageId)
               
               ' Output acknowledgment message information. The correlation Id is identical
               ' to the id of the original message.
               Console.WriteLine("Acknowledgment Message Information--")
               Console.WriteLine(("Correlation Id: " + myAcknowledgmentMessage.CorrelationId.ToString()))
               Console.WriteLine(("Id: " + myAcknowledgmentMessage.Id.ToString()))
               Console.WriteLine(("Acknowledgment Type: " + myAcknowledgmentMessage.Acknowledgment.ToString()))
               Console.WriteLine("____________________________________________")
               
               found = True
            End While
         Catch e As InvalidOperationException
            ' This exception would be thrown if there is no (further) acknowledgment message
            ' with the specified correlation Id. Only output a message if there are no messages;
            ' not if the loop has found at least one.
            If found = False Then
               Console.WriteLine(e.Message)
            End If
         End Try 
   End Sub
 End Class 'MyNewQueue

備註

Acknowledgment類別會定義訊息佇列在管理佇列中張貼的通知訊息類型, 以及導致傳送通知訊息的條件。The Acknowledgment class defines the types of acknowledgment messages that Message Queuing posts in the administration queue and the conditions that cause an acknowledgment message to be sent. 通知類型可廣泛分成四個群組: 正面抵達通知、正面讀取通知、否定抵達通知和負讀取通知。Acknowledgment types can be divided broadly into four groups: positive arrival acknowledgments, positive read acknowledgments, negative arrival acknowledgments, and negative read acknowledgments.

與訊息相關聯的管理佇列是在Message.AdministrationQueue屬性中指定。The administration queue associated with message is specified in the Message.AdministrationQueue property.

訊息佇列會在Message.Acknowledgment建立認可訊息時, Acknowledgment將屬性設定為其中一個列舉值。Message Queuing sets the Message.Acknowledgment property to one of the Acknowledgment enumeration values when it creates an acknowledgment message. Message.Acknowledgment屬性值通常只有在實例參考系統傳送的通知訊息時才有意義。The Message.Acknowledgment property value is typically meaningful only when the instance refers to a system-sent acknowledgment message. 讀取認可Message.Acknowledgment訊息以外訊息的屬性會擲回例外狀況。Reading the Message.Acknowledgment property for a message other than an acknowledgment message throws an exception.

除非傳送的應用程式要求它這麼做, 否則訊息佇列不會傳送確認訊息。Message Queuing does not send an acknowledgment message unless the sending application requests that it do so. 您的應用程式會藉由設定適當的Message.AcknowledgeType屬性值來提出此要求。Your application makes this request by setting the appropriate value for the Message.AcknowledgeType property. 訊息佇列會將所有認可訊息傳送至原始AdministrationQueue Message的屬性中指定的管理佇列。Message Queuing sends all acknowledgment messages to the administration queue specified in the AdministrationQueue property of the original Message.

適用於