DefaultPropertiesToSend Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Specifica i valori predefiniti delle proprietà che verranno utilizzati per l'invio di oggetti diversi da istanze Message a una coda di messaggi.
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
- Ereditarietà
-
DefaultPropertiesToSend
- Attributi
Esempio
Nell'esempio di codice seguente viene utilizzata la priorità di un messaggio per determinare le proprietà predefinite da inviare per il messaggio.
#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
Commenti
È possibile impostare i valori predefiniti sulle proprietà selezionate per i messaggi inviati a un MessageQueueoggetto . DefaultPropertiesToSend viene usato per specificare i valori di proprietà predefiniti del messaggio inviato quando gli oggetti diversi da Message istanze vengono inviati a una coda, ad esempio l'argomento stringa passato al Send metodo nel frammento di codice, myMessageQueue.Send("hello")
. La Message classe ha proprietà corrispondenti, denominate in modo identico a quelle in DefaultPropertiesToSend che forniscono i valori durante l'invio di un'istanza Message in modo specifico. Anche se è stato specificato MessageQueue.DefaultPropertiesToSend per una coda, l'invio di DefaultPropertiesToSend un Message oggetto a tale coda causerà l'override dei valori delle proprietà denominate Message in modo identico.
Proprietà non impostate in modo esplicito sui valori specificati dal costruttore, DefaultPropertiesToSend.
Per un elenco di valori di proprietà iniziali per un'istanza di DefaultPropertiesToSend, vedere il DefaultPropertiesToSend costruttore.
Costruttori
DefaultPropertiesToSend() |
Inizializza una nuova istanza della classe DefaultPropertiesToSend. |
Proprietà
AcknowledgeType |
Ottiene o imposta il tipo di messaggio di riconoscimento da restituire all'applicazione che esegue l'invio. |
AdministrationQueue |
Ottiene o imposta la coda di ricezione dei messaggi di riconoscimento generati da Accodamento messaggi. |
AppSpecific |
Ottiene o imposta informazioni aggiuntive specifiche di un'applicazione. |
AttachSenderId |
Ottiene o imposta un valore che indica se l'ID del mittente deve essere allegato al messaggio. |
EncryptionAlgorithm |
Ottiene o imposta l'algoritmo di crittografia utilizzato per crittografare il corpo di un messaggio privato. |
Extension |
Ottiene o imposta informazioni aggiuntive associate al messaggio. |
HashAlgorithm |
Ottiene o imposta l'algoritmo hash utilizzato per autenticare i messaggi o creare una firma digitale per un messaggio. |
Label |
Ottiene o imposta una stringa definita dall'applicazione che descrive il messaggio. |
Priority |
Ottiene o imposta la priorità del messaggio, che viene utilizzata per determinare la posizione del messaggio nella coda. |
Recoverable |
Ottiene o imposta un valore che indica che il recapito del messaggio è garantito anche nel caso di un malfunzionamento del computer o di un problema di rete. |
ResponseQueue |
Ottiene o imposta la coda che riceve i messaggi di risposta generati dall'applicazione. |
TimeToBeReceived |
Ottiene o imposta il limite di tempo per il recupero del messaggio dalla coda di destinazione. |
TimeToReachQueue |
Ottiene o imposta il limite di tempo impiegato dal messaggio per raggiungere la coda. |
TransactionStatusQueue |
Ottiene la coda di stato della transazione sul computer di origine. |
UseAuthentication |
Ottiene o imposta un valore che indica se il messaggio deve essere autenticato prima del suo invio. |
UseDeadLetterQueue |
Ottiene o imposta un valore che indica se una copia del messaggio non recapitato deve essere inviata a una coda dei messaggi non recapitabili. |
UseEncryption |
Ottiene o imposta un valore che indica se rendere privato il messaggio. |
UseJournalQueue |
Ottiene o imposta un valore che indica se è necessario inserire una copia del messaggio nel journal del computer di origine. |
UseTracing |
Ottiene o imposta un valore che indica se tenere traccia di un messaggio mentre procede verso la coda di destinazione. |
Metodi
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |