DefaultPropertiesToSend Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica os valores de propriedade padrão que serão usados ao enviar objetos diferentes das instâncias Message 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 = classPublic Class DefaultPropertiesToSend- Herança
-
DefaultPropertiesToSend
- Atributos
Exemplos
O exemplo de código a seguir usa a prioridade de uma mensagem para determinar as propriedades padrão a serem enviadas 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
Comentários
Você pode definir valores padrão em propriedades selecionadas para mensagens enviadas para um MessageQueue. DefaultPropertiesToSend é usado para especificar valores de propriedade padrão da mensagem que está sendo enviada quando objetos diferentes de Message instâncias são enviados para uma fila, por exemplo, o argumento de cadeia de caracteres passado para o Send método no fragmento de código, myMessageQueue.Send("hello"). A Message classe tem propriedades correspondentes e nomeadas de forma idêntica àquelas em DefaultPropertiesToSend que fornecem os valores ao enviar uma Message instância especificamente. Mesmo que você tenha especificado MessageQueue.DefaultPropertiesToSend para uma fila, enviar um Message objeto para essa fila fará com que os valores das propriedades nomeadas Message de forma idêntica substituam os valores da DefaultPropertiesToSend fila.
Propriedades que você não define explicitamente padrão para os valores especificados pelo construtor, DefaultPropertiesToSend.
Para obter uma lista de valores de propriedade iniciais para uma instância do DefaultPropertiesToSend, consulte o DefaultPropertiesToSend construtor .
Construtores
| DefaultPropertiesToSend() |
Inicializa uma nova instância da classe DefaultPropertiesToSend. |
Propriedades
| AcknowledgeType |
Obtém ou define o tipo de mensagem de confirmação a ser retornada para o aplicativo de envio. |
| AdministrationQueue |
Obtém ou define a fila que recebe as mensagens de confirmação geradas pelo Enfileiramento de Mensagens. |
| AppSpecific |
Obtém ou define informações adicionais específicas do aplicativo. |
| AttachSenderId |
Obtém ou define um valor que indica se a ID do remetente deve ser anexada à mensagem. |
| EncryptionAlgorithm |
Obtém ou define o algoritmo de criptografia usado para criptografar o corpo de uma mensagem privada. |
| Extension |
Obtém ou define informações adicionais associadas à mensagem. |
| HashAlgorithm |
Obtém ou define o algoritmo de hash usado ao autenticar mensagens ou criar uma assinatura digital para uma mensagem. |
| Label |
Obtém ou define uma cadeia de caracteres definida pelo aplicativo que descreve a mensagem. |
| Priority |
Obtém ou define a prioridade da mensagem, que é usada para determinar se a mensagem foi colocada na fila. |
| Recoverable |
Obtém ou define um valor que indica se há garantia de que a mensagem seja entregue no caso de um problema de rede ou falha do computador. |
| ResponseQueue |
Obtém ou define a fila que recebe mensagens de resposta geradas por aplicativo. |
| TimeToBeReceived |
Obtém ou define o limite de tempo para a mensagem ser recuperada da fila de destino. |
| TimeToReachQueue |
Obtém ou define o tempo limite para a mensagem chegar à fila. |
| TransactionStatusQueue |
Obtém a fila de status de transação no computador de origem. |
| UseAuthentication |
Obtém ou define um valor que indica se a mensagem deve ser autenticada antes de ser enviada. |
| UseDeadLetterQueue |
Obtém ou define um valor que indica se uma cópia da mensagem que não pôde ser entregue deve ser enviada a uma fila de mensagens mortas. |
| UseEncryption |
Obtém ou define um valor que indica se a mensagem deve ser tornada privada. |
| UseJournalQueue |
Obtém ou define um valor que indica se uma cópia da mensagem deve ser mantida em um diário de computador no computador de origem. |
| UseTracing |
Obtém ou define um valor que indica se uma mensagem deve ser rastreada enquanto ela se aproxima da sua fila de destino. |
Métodos
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
