DefaultPropertiesToSend DefaultPropertiesToSend DefaultPropertiesToSend DefaultPropertiesToSend Class

Определение

Задает значения свойств по умолчанию, которые будут использоваться при передаче в очередь сообщений объектов, отличающихся от экземпляра Message.Specifies the default property values that will be used when sending objects other than Message instances to a message queue.

public ref class DefaultPropertiesToSend
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public class DefaultPropertiesToSend
type DefaultPropertiesToSend = class
Public Class DefaultPropertiesToSend
Наследование
DefaultPropertiesToSendDefaultPropertiesToSendDefaultPropertiesToSendDefaultPropertiesToSend
Атрибуты

Примеры

В следующем примере кода используется приоритет сообщения для определения свойств по умолчанию для отправки сообщения.The following code example uses the priority of a message to determine default properties to send for the message.

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

using namespace System;
using namespace System::Messaging;
ref class MyNewQueue
{
public:

   // Associates selected message property values
   // with high priority messages.
   void SendHighPriorityMessages()
   {
      
      // Connect to a message queue.
      MessageQueue^ myQueue = gcnew MessageQueue( ".\\myQueue" );
      
      // Associate selected default property values with high
      // priority messages.
      myQueue->DefaultPropertiesToSend->Priority = MessagePriority::High;
      myQueue->DefaultPropertiesToSend->Label = "High Priority Message";
      myQueue->DefaultPropertiesToSend->Recoverable = true;
      myQueue->DefaultPropertiesToSend->TimeToReachQueue = TimeSpan(0,0,30);
      
      // Send messages using these defaults.
      myQueue->Send( "High priority message data 1." );
      myQueue->Send( "High priority message data 2." );
      myQueue->Send( "High priority message data 3." );
      return;
   }


   // Associates selected message property values
   // with normal priority messages.
   void SendNormalPriorityMessages()
   {
      
      // Connect to a message queue.
      MessageQueue^ myQueue = gcnew MessageQueue( ".\\myQueue" );
      
      // Associate selected default property values with normal
      // priority messages.
      myQueue->DefaultPropertiesToSend->Priority = MessagePriority::Normal;
      myQueue->DefaultPropertiesToSend->Label = "Normal Priority Message";
      myQueue->DefaultPropertiesToSend->Recoverable = false;
      myQueue->DefaultPropertiesToSend->TimeToReachQueue = TimeSpan(0,2,0);
      
      // Send messages using these defaults.
      myQueue->Send( "Normal priority message data 1." );
      myQueue->Send( "Normal priority message data 2." );
      myQueue->Send( "Normal priority message data 3." );
      return;
   }

};


// Provides an entry point into the application.
// This example specifies different types of default
// properties for messages.
int main()
{
   
   // Create a new instance of the class.
   MyNewQueue^ myNewQueue = gcnew MyNewQueue;
   
   // Send normal and high priority messages.
   myNewQueue->SendNormalPriorityMessages();
   myNewQueue->SendHighPriorityMessages();
   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 specifies different types of default
		// properties for messages.
		//**************************************************

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

			// Send normal and high priority messages.
			myNewQueue.SendNormalPriorityMessages();
			myNewQueue.SendHighPriorityMessages();
						
			return;
		}


		//**************************************************
		// Associates selected message property values
		// with high priority messages.
		//**************************************************
		
		public void SendHighPriorityMessages()
		{

			// Connect to a message queue.
			MessageQueue myQueue = new 
				MessageQueue(".\\myQueue");

			// Associate selected default property values with high
			// priority messages.
			myQueue.DefaultPropertiesToSend.Priority = 
				MessagePriority.High;
			myQueue.DefaultPropertiesToSend.Label = 
				"High Priority Message";
			myQueue.DefaultPropertiesToSend.Recoverable = true;
			myQueue.DefaultPropertiesToSend.TimeToReachQueue =
				new TimeSpan(0,0,30);
			
			// Send messages using these defaults.
			myQueue.Send("High priority message data 1.");
			myQueue.Send("High priority message data 2.");
			myQueue.Send("High priority message data 3.");
			
			return;
		}


		//**************************************************
		// Associates selected message property values
		// with normal priority messages.
		//**************************************************
		
		public void SendNormalPriorityMessages()
		{

			// Connect to a message queue.
			MessageQueue myQueue = new MessageQueue(".\\myQueue");

			// Associate selected default property values with normal
			// priority messages.
			myQueue.DefaultPropertiesToSend.Priority = 
				MessagePriority.Normal;
			myQueue.DefaultPropertiesToSend.Label = 
				"Normal Priority Message";
			myQueue.DefaultPropertiesToSend.Recoverable = false;
			myQueue.DefaultPropertiesToSend.TimeToReachQueue =
				new TimeSpan(0,2,0);
			
			// Send messages using these defaults.
			myQueue.Send("Normal priority message data 1.");
			myQueue.Send("Normal priority message data 2.");
			myQueue.Send("Normal priority message data 3.");
			
			return;
		}
	}
}
Imports System.Messaging

Public Class MyNewQueue



        ' Provides an entry point into the application.
        '		 
        ' This example specifies different types of default
        ' properties for messages.


        Public Shared Sub Main()

            ' Create a new instance of the class.
            Dim myNewQueue As New MyNewQueue()

            ' Send normal and high priority messages.
            myNewQueue.SendNormalPriorityMessages()
            myNewQueue.SendHighPriorityMessages()

            Return

        End Sub 'Main



        ' Associates selected message property values
        ' with high priority messages.
 

        Public Sub SendHighPriorityMessages()

            ' Connect to a message queue.
            Dim myQueue As New MessageQueue(".\myQueue")

            ' Associate selected default property values with high
            ' priority messages.
            myQueue.DefaultPropertiesToSend.Priority = _
                MessagePriority.High
            myQueue.DefaultPropertiesToSend.Label = _
                "High Priority Message"
            myQueue.DefaultPropertiesToSend.Recoverable = True
            myQueue.DefaultPropertiesToSend.TimeToReachQueue = _
                New TimeSpan(0, 0, 30)

            ' Send messages using these defaults.
            myQueue.Send("High priority message data 1.")
            myQueue.Send("High priority message data 2.")
            myQueue.Send("High priority message data 3.")

            Return

        End Sub 'SendHighPriorityMessages



        ' Associates selected message property values
        ' with normal priority messages.

        Public Sub SendNormalPriorityMessages()

            ' Connect to a message queue.
            Dim myQueue As New MessageQueue(".\myQueue")

            ' Associate selected default property values with normal
            ' priority messages.
            myQueue.DefaultPropertiesToSend.Priority = _
                MessagePriority.Normal
            myQueue.DefaultPropertiesToSend.Label = _
                "Normal Priority Message"
            myQueue.DefaultPropertiesToSend.Recoverable = False
            myQueue.DefaultPropertiesToSend.TimeToReachQueue = _
                New TimeSpan(0, 2, 0)

            ' Send messages using these defaults.
            myQueue.Send("Normal priority message data 1.")
            myQueue.Send("Normal priority message data 2.")
            myQueue.Send("Normal priority message data 3.")

            Return

        End Sub 'SendNormalPriorityMessages

End Class 'MyNewQueue

Комментарии

Можно задать значения по умолчанию для выбранных свойств сообщений, MessageQueueотправляемых в.You can set default values on selected properties for messages sent to a MessageQueue. DefaultPropertiesToSendиспользуется для указания значений свойств по умолчанию для сообщения, отправляемого при отправке Message в очередь объектов, отличных от экземпляров, например строкового аргумента, передаваемого Send в метод myMessageQueue.Send("hello")в фрагменте кода.DefaultPropertiesToSend is used to specify default property values of the message being sent when objects other than Message instances are sent to a queue, for example, the string argument passed into the Send method in the code fragment, myMessageQueue.Send("hello"). Класс имеет соответствующие идентичные именованные свойства для DefaultPropertiesToSend тех, которые предоставляют значения при отправке Message экземпляра специально. MessageThe Message class has corresponding, identically named properties to those in DefaultPropertiesToSend that provide the values when sending a Message instance specifically. Даже если вы указали MessageQueue.DefaultPropertiesToSend для очереди, Message Отправка объекта в эту очередь приведет к тому, что значения свойств с одинаковыми именами Message переопределят DefaultPropertiesToSend значения очереди.Even if you have specified MessageQueue.DefaultPropertiesToSend for a queue, sending a Message object to that queue will cause the values for the identically named Message properties to override the queue's DefaultPropertiesToSend values.

Свойства, которые не заданы явным образом по умолчанию, имеют значения, DefaultPropertiesToSendзаданные конструктором.Properties that you do not set explicitly default to the values specified by the constructor, DefaultPropertiesToSend.

Список начальных значений свойств для экземпляра DefaultPropertiesToSendсм. в DefaultPropertiesToSend разделе Конструктор.For a list of initial property values for an instance of DefaultPropertiesToSend, see the DefaultPropertiesToSend constructor.

Конструкторы

DefaultPropertiesToSend() DefaultPropertiesToSend() DefaultPropertiesToSend() DefaultPropertiesToSend()

Инициализирует новый экземпляр класса DefaultPropertiesToSend.Initializes a new instance of the DefaultPropertiesToSend class.

Свойства

AcknowledgeType AcknowledgeType AcknowledgeType AcknowledgeType

Получает или задает тип сообщения подтверждения, которое должно возвращаться приложению, передающему исходное сообщение.Gets or sets the type of acknowledgement message to be returned to the sending application.

AdministrationQueue AdministrationQueue AdministrationQueue AdministrationQueue

Получает или задает очередь, принимающую сообщения подтверждения, сформированные службой Message Queuing.Gets or sets the queue that receives acknowledgement messages generated by Message Queuing.

AppSpecific AppSpecific AppSpecific AppSpecific

Получает или задает дополнительные сведения, зависящие от приложения.Gets or sets additional, application-specific information.

AttachSenderId AttachSenderId AttachSenderId AttachSenderId

Получает или задает значение, указывающее, должен ли быть присоединен к сообщению идентификатор отправителя.Gets or sets a value that indicates whether the sender ID should be attached to the message.

EncryptionAlgorithm EncryptionAlgorithm EncryptionAlgorithm EncryptionAlgorithm

Получает или задает алгоритм шифрования, используемый для шифрования тела конфиденциального сообщения.Gets or sets the encryption algorithm used to encrypt the body of a private message.

Extension Extension Extension Extension

Получает или задает дополнительные сведения, связанные с данным сообщением.Gets or sets additional information associated with the message.

HashAlgorithm HashAlgorithm HashAlgorithm HashAlgorithm

Получает или задает алгоритм хэширования, используемый при проверке подлинности сообщений или создании цифровой подписи для сообщения.Gets or sets the hashing algorithm used when authenticating messages or creating a digital signature for a message.

Label Label Label Label

Получает или задает определяемую приложением строку, описывающую данное сообщение.Gets or sets an application-defined string that describes the message.

Priority Priority Priority Priority

Получает или задает приоритет сообщения, используемый для определения места сообщения при его поступлении в очередь.Gets or sets the message priority, which is used to determine where the message is placed in the queue.

Recoverable Recoverable Recoverable Recoverable

Получает или задает значение, показывающее, будет ли сообщение гарантированно доставлено в случае отказа компьютера или неисправности в сети.Gets or sets a value that indicates whether the message is guaranteed to be delivered in the event of a computer failure or network problem.

ResponseQueue ResponseQueue ResponseQueue ResponseQueue

Получает или задает очередь, принимающую ответные сообщения, создаваемые приложением.Gets or sets the queue that receives application-generated response messages.

TimeToBeReceived TimeToBeReceived TimeToBeReceived TimeToBeReceived

Получает или задает лимит времени, в течение которого сообщение должно быть извлечено из очереди места назначения.Gets or sets the time limit for the message to be retrieved from the destination queue.

TimeToReachQueue TimeToReachQueue TimeToReachQueue TimeToReachQueue

Получает или задает лимит времени, в течение которого сообщение должно дойти до очереди.Gets or sets the time limit for the message to reach the queue.

TransactionStatusQueue TransactionStatusQueue TransactionStatusQueue TransactionStatusQueue

Получает очередь состояний транзакций на компьютере-источнике.Gets the transaction status queue on the source computer.

UseAuthentication UseAuthentication UseAuthentication UseAuthentication

Получает или задает значение, указывающее, должна ли проводиться проверка подлинности сообщения до его отправки.Gets or sets a value that indicates whether the message must be authenticated before being sent.

UseDeadLetterQueue UseDeadLetterQueue UseDeadLetterQueue UseDeadLetterQueue

Получает или задает значение, указывающее, должна ли копия сообщения, которое не может быть доставлено, передаваться в очередь недоставленных сообщений.Gets or sets a value that indicates whether a copy of the message that could not be delivered should be sent to a dead-letter queue.

UseEncryption UseEncryption UseEncryption UseEncryption

Получает или задает значение, определяющее, является ли сообщение конфиденциальным.Gets or sets a value that indicates whether to make the message private.

UseJournalQueue UseJournalQueue UseJournalQueue UseJournalQueue

Получает или задает значение, указывающее, должна ли копия сообщения храниться в журнале компьютера, являющегося источником этого сообщения.Gets or sets a value that indicates whether a copy of the message should be kept in a machine journal on the originating computer.

UseTracing UseTracing UseTracing UseTracing

Получает или задает значение, указывающее, нужно ли отслеживать сообщение в процессе его перемещения в очередь места назначения.Gets or sets a value that indicates whether to trace a message as it moves toward its destination queue.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Применяется к

Дополнительно