DefaultPropertiesToSend Classe

Definizione

Specifica i valori predefiniti delle proprietà che verranno utilizzati per l'invio di oggetti diversi da istanze Message a una coda di messaggi.

[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
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;
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;
        }
    }
}

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)

Si applica a

Prodotto Versioni
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Vedi anche