DefaultPropertiesToSend Clase

Definición

Espacio de nombres:: System.Messaging

Ensamblado:: System.Messaging.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Especifica los valores de propiedad predeterminados que se usarán al enviar objetos distintos de Message instancias a una cola de mensajes.

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

Herencia: Object
DefaultPropertiesToSend

Atributos: TypeConverterAttribute

Ejemplos

En el ejemplo de código siguiente se usa la prioridad de un mensaje para determinar las propiedades predeterminadas que se van a enviar para el mensaje.

#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

Comentarios

Puede establecer valores predeterminados en las propiedades seleccionadas para los mensajes enviados a .MessageQueue DefaultPropertiesToSend se usa para especificar valores de propiedad predeterminados del mensaje que se envían cuando los objetos distintos de Message las instancias se envían a una cola, por ejemplo, el argumento de cadena pasado al Send método en el fragmento de código, myMessageQueue.Send("hello"). La Message clase tiene propiedades correspondientes, con un nombre idéntico a las DefaultPropertiesToSend de que proporcionan los valores al enviar una Message instancia específicamente. Incluso si ha especificado MessageQueue.DefaultPropertiesToSend para una cola, el envío de un Message objeto a esa cola hará que los valores de las propiedades con nombre Message idéntico invaliden los valores de DefaultPropertiesToSend la cola.

Propiedades que no se establecen explícitamente de forma predeterminada en los valores especificados por el constructor, DefaultPropertiesToSend.

Para obtener una lista de valores de propiedad iniciales para una instancia de DefaultPropertiesToSend, vea el DefaultPropertiesToSend constructor .

Constructores

Nombre	Description
DefaultPropertiesToSend()	Inicializa una nueva instancia de la clase DefaultPropertiesToSend.

Propiedades

Nombre	Description
AcknowledgeType	Obtiene o establece el tipo de mensaje de confirmación que se va a devolver a la aplicación de envío.
AdministrationQueue	Obtiene o establece la cola que recibe los mensajes de confirmación generados por Message Queuing.
AppSpecific	Obtiene o establece información adicional específica de la aplicación.
AttachSenderId	Obtiene o establece un valor que indica si el identificador del remitente debe adjuntarse al mensaje.
EncryptionAlgorithm	Obtiene o establece el algoritmo de cifrado utilizado para cifrar el cuerpo de un mensaje privado.
Extension	Obtiene o establece información adicional asociada al mensaje.
HashAlgorithm	Obtiene o establece el algoritmo hash utilizado al autenticar mensajes o crear una firma digital para un mensaje.
Label	Obtiene o establece una cadena definida por la aplicación que describe el mensaje.
Priority	Obtiene o establece la prioridad del mensaje, que se usa para determinar dónde se coloca el mensaje en la cola.
Recoverable	Obtiene o establece un valor que indica si se garantiza que el mensaje se entregue en caso de un error del equipo o un problema de red.
ResponseQueue	Obtiene o establece la cola que recibe mensajes de respuesta generados por la aplicación.
TimeToBeReceived	Obtiene o establece el límite de tiempo del mensaje que se va a recuperar de la cola de destino.
TimeToReachQueue	Obtiene o establece el límite de tiempo para que el mensaje llegue a la cola.
TransactionStatusQueue	Obtiene la cola de estado de transacción en el equipo de origen.
UseAuthentication	Obtiene o establece un valor que indica si el mensaje debe autenticarse antes de enviarse.
UseDeadLetterQueue	Obtiene o establece un valor que indica si se debe enviar una copia del mensaje que no se pudo entregar a una cola de mensajes fallidos.
UseEncryption	Obtiene o establece un valor que indica si se va a privado el mensaje.
UseJournalQueue	Obtiene o establece un valor que indica si se debe mantener una copia del mensaje en un diario de máquina en el equipo de origen.
UseTracing	Obtiene o establece un valor que indica si se va a realizar un seguimiento de un mensaje a medida que se mueve hacia su cola de destino.

Métodos

Nombre	Description
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Se aplica a

Consulte también

Comentarios

¿Le ha resultado útil esta página?