DefaultPropertiesToSend Classe

Definição

Espaço de Nomes:
System.Messaging
Assemblagem:
System.Messaging.dll

Especifica os valores de propriedades padrão que serão usados ao enviar objetos que não Message sejam instâncias para uma fila de mensagens.

public ref class DefaultPropertiesToSend
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public class DefaultPropertiesToSend
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))>]
type DefaultPropertiesToSend = class
Public Class DefaultPropertiesToSend
Herança
Object
DefaultPropertiesToSend
Atributos
TypeConverterAttribute

Exemplos

O exemplo de código seguinte utiliza a prioridade de uma mensagem para determinar as propriedades padrão a enviar para a mensagem.

#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



        ' 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



        ' 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

End Class

Observações

Pode definir valores predefinidos em propriedades selecionadas para mensagens enviadas para um MessageQueue. DefaultPropertiesToSend é usado para especificar valores de propriedades por defeito da mensagem enviada quando objetos que não Message são instâncias são enviados para uma fila, por exemplo, o argumento de cadeia passado para o Send método no fragmento de código, myMessageQueue.Send("hello"). A Message classe tem propriedades correspondentes, com nomes idênticos, às que DefaultPropertiesToSend fornecem os valores ao enviar uma Message instância especificamente. Mesmo que tenhas especificado MessageQueue.DefaultPropertiesToSend para uma fila, enviar um Message objeto para essa fila fará com que os valores das propriedades com nomes Message idênticos sobreponham os valores da DefaultPropertiesToSend fila.

As propriedades que não definires correspondem explicitamente aos valores especificados pelo construtor, DefaultPropertiesToSend.

Para obter uma lista de valores das propriedades iniciais de uma instância de DefaultPropertiesToSend, consulte o construtor DefaultPropertiesToSend.

Construtores

Name Description
DefaultPropertiesToSend()

Inicializa uma nova instância da DefaultPropertiesToSend classe.

Propriedades

Name Description
AcknowledgeType

Recebe ou define o tipo de mensagem de confirmação a ser devolvida à aplicação enviante.
AdministrationQueue

Recebe ou define a fila que recebe as mensagens de confirmação geradas pela Fila de Mensagens.
AppSpecific

Obtém ou define informação adicional específica para a aplicação.
AttachSenderId

Recebe ou define um valor que indica se o ID do remetente deve ser associado à mensagem.
EncryptionAlgorithm

Obtém ou define o algoritmo de encriptação usado para encriptar o corpo de uma mensagem privada.
Extension

Obtém ou define informações adicionais associadas à mensagem.
HashAlgorithm

Obtém ou define o algoritmo de hashing usado ao autenticar mensagens ou criar uma assinatura digital para uma mensagem.
Label

Recebe ou define uma cadeia definida pela aplicação que descreve a mensagem.
Priority

Recebe ou define a prioridade da mensagem, que é usada para determinar onde a mensagem está colocada na fila.
Recoverable

Recebe ou define um valor que indica se a mensagem está garantida para ser entregue em caso de falha informática ou problema de rede.
ResponseQueue

Recebe ou define a fila que recebe as mensagens de resposta geradas pela aplicação.
TimeToBeReceived

Obtém ou define o limite de tempo para a mensagem ser recuperada da fila de destino.
TimeToReachQueue

Obtém ou define o limite de tempo para a mensagem chegar à fila.
TransactionStatusQueue

Recebe a fila de estado da transação no computador de origem.
UseAuthentication

Recebe ou define um valor que indica se a mensagem deve ser autenticada antes de ser enviada.
UseDeadLetterQueue

Recebe ou define um valor que indica se uma cópia da mensagem que não pôde ser entregue deve ser enviada para uma fila de letras mortas.
UseEncryption

Recebe ou define um valor que indica se deve tornar a mensagem privada.
UseJournalQueue

Recebe ou define um valor que indica se uma cópia da mensagem deve ser mantida num diário de máquina no computador de origem.
UseTracing

Recebe ou define um valor que indica se deve rastrear uma mensagem à medida que esta se aproxima da fila de destino.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também