DefaultPropertiesToSend Clase
Definición
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 utilizarán al enviar objetos diferentes de las instancias de Message 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 = classPublic Class DefaultPropertiesToSend- Herencia
-
DefaultPropertiesToSend
- Atributos
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 Message de 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 con nombre idénticos a las de DefaultPropertiesToSend 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
| DefaultPropertiesToSend() |
Inicializa una nueva instancia de la clase DefaultPropertiesToSend. |
Propiedades
| AcknowledgeType |
Obtiene o establece el tipo de mensaje de confirmación que debe devolverse a la aplicación que hace el envío. |
| AdministrationQueue |
Obtiene o establece la cola utilizada para 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 se adjuntará al mensaje el identificador del remitente. |
| EncryptionAlgorithm |
Obtiene o establece el algoritmo de cifrado que se utiliza para cifrar el cuerpo de un mensaje privado. |
| Extension |
Obtiene o establece información adicional asociada al mensaje. |
| HashAlgorithm |
Obtiene o establece el algoritmo de hash que se emplea al autenticar mensajes o al 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 utiliza para determinar en qué punto de la cola se ubica el mensaje. |
| Recoverable |
Obtiene o establece un valor que indica si se garantiza la entrega del mensaje en caso de haber errores en el equipo o problemas en la red. |
| ResponseQueue |
Obtiene o establece la cola que recibe los mensajes de respuesta generados por la aplicación. |
| TimeToBeReceived |
Obtiene o establece el límite de tiempo para recuperar el mensaje de la cola de destino. |
| TimeToReachQueue |
Obtiene o establece el límite de tiempo para que el mensaje alcance la cola. |
| TransactionStatusQueue |
Obtiene la cola de estado de transacción del equipo de origen. |
| UseAuthentication |
Obtiene o establece un valor que indica si debe autenticarse el mensaje antes de enviarse. |
| UseDeadLetterQueue |
Obtiene o establece un valor que indica si debe enviarse una copia del mensaje que no pudo entregarse a la cola de mensajes no enviados. |
| UseEncryption |
Obtiene o establece un valor que indica si el mensaje debe ser privado. |
| UseJournalQueue |
Obtiene o establece un valor que indica si debe conservarse una copia del mensaje en un diario del equipo de origen. |
| UseTracing |
Obtiene o establece un valor que indica si se debe seguir la traza de un mensaje mientras se traslada a su cola de destino. |
Métodos
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetHashCode() |
Sirve 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 Object actual. (Heredado de Object) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
