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 = classPublic 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 per le proprietà selezionate per i messaggi inviati a un oggetto MessageQueue. DefaultPropertiesToSend viene usato per specificare i valori di proprietà predefiniti del messaggio inviato quando gli oggetti diversi dalle 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 un Message oggetto a tale coda causerà l'override dei valori delle DefaultPropertiesToSend proprietà denominate Message in modo identico.
Proprietà non impostate in modo esplicito sui valori specificati dal costruttore , DefaultPropertiesToSend.
Per un elenco dei valori iniziali delle proprietà 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) |
