<integrazioneMsmq>

  • Articolo

Specifica un trasporto MSMQ per un'associazione personalizzata.

<Configurazione>
  <system.serviceModel>
    <Associazioni>
      <Custombinding>
        <Associazione>
          <integrazioneMsmq>

Sintassi

<msmqIntegration customDeadLetterQueue="Uri"
                 deadLetterQueue="Custom/None/System"
                 durable="Boolean"
                 exactlyOnce="Boolean"
                 manualAddressing="Boolean"
                 maxBufferPoolSize="Integer"
                 maxImmediateRetries="Integer"
                 maxReceivedMessageSize="Integer"
                 maxRetryCycles="Integer"
                 rejectAfterLastRetry="Boolean"
                 retryCycleDelay="TimeSpan"
                 serializationFormat="XML/Binary/ActiveX/ByteArray/Stream"
                 timeToLive="TimeSpan"
                 useSourceJournal="Boolean"
                 useMsmqTracing="Boolean">
  <msmqTransportSecurity>
  </msmqTransportSecurity>
</msmqIntegration>

Tipo

Type

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo Descrizione
customDeadLetterQueue URI che indica il percorso della coda dei messaggi non recapitabili per applicazione. In tale coda vengono collocati i messaggi scaduti o non recapitabili all'applicazione.

Per i messaggi che richiedono la garanzia ExactlyOnce, ovvero l'impostazione dell'attributo exactlyOnce su true, questo attributo viene impostato come valore predefinito sulla coda transazionale dei messaggi non recapitabili a livello di sistema di MSMQ.

Per i messaggi che non richiedono alcuna garanzia, ovvero per i messaggi il cui attributo exactlyOnce è impostato su false, l'impostazione predefinita dell'attributo è null.

Il valore deve usare lo schema net.msmq. Il valore predefinito è null.

Se deadLetterQueue è impostato su None o su System, questo attributo deve essere impostato su null. Se questo attributo non viene impostato su null, deadLetterQueue deve essere impostato su Custom.
deadLetterQueue Specifica il tipo di coda dei messaggi non recapitabili da usare.

I valori validi includono

- Personalizzato: coda di messaggi non recapitabili personalizzata.
- Nessuno: non deve essere usata alcuna coda di messaggi non recapitabili.
- Sistema: usare la coda di messaggi non recapitabili del sistema.

L'attributo è di tipo DeadLetterQueue.
durable Valore booleano che specifica se i messaggi elaborati da questa associazione sono durevoli o volatili. Il valore predefinito è true.

Un messaggio durevole sopravvive a un arresto del gestore delle code, un messaggio volatile no. I messaggi volatili sono utili quando le applicazioni richiedono minore latenza e possono tollerare messaggi perduti occasionalmente.

Se exactlyOnce è impostato su true, i messaggi devono essere durevoli.
exactlyOnce Valore booleano che indica se i messaggi elaborati da questa associazione verranno ricevuti una sola volta. Il valore predefinito è true.

Un messaggio può essere inviato con o senza garanzie. Una garanzia consente a un'applicazione di verificare che un messaggio inviato abbia raggiunto la coda dei messaggi del destinatario. In caso contrario, l'applicazione può determinarlo leggendo la coda dei messaggi non recapitabili.

Quando exactlyOnce è impostato su true indica che MSMQ verificherà che un messaggio inviato sia recapitato una sola volta alla coda dei messaggi del destinatario e, se il recapito non riesce, il messaggio viene inviato alla coda dei messaggi non recapitabili.

I messaggi inviati con la proprietà exactlyOnce impostata su true devono essere inviati solo a una coda transazionale.
manualAddressing Valore booleano che consente all'utente di assumere il controllo dell'indirizzamento dei messaggi. Questa proprietà viene usata in genere in scenari di router, in cui è l'applicazione a determinare a quale delle tante destinazioni inviare un messaggio.

Quando è impostato su true, il canale presuppone che il messaggio sia già stato indirizzato e non aggiunge ulteriori informazioni. L'utente può indirizzare quindi individualmente ogni messaggio.

Quando è impostato su false, il meccanismo di indirizzamento predefinito di Windows Communication Foundation (WCF) crea automaticamente indirizzi per tutti i messaggi.

Il valore predefinito è false.
maxBufferPoolSize Numero intero positivo che specifica la dimensione massima del pool di buffer. Il valore predefinito è 524288.

Molte parti di WCF usano buffer. La creazione e l'eliminazione definitiva dei buffer a ogni uso sono operazioni onerose, analogamente a quelle di Garbage Collection dei buffer. Quando si usa un pool di buffer è possibile prelevare un buffer dal pool, usarlo e, al termine delle operazioni, riporlo nel pool. In questo modo è possibile evitare il sovraccarico dovuto alla creazione e all'eliminazione definitiva dei buffer.
maxImmediateRetries Intero che specifica il numero massimo di tentativi immediati in un messaggio letto dalla coda dell'applicazione. Il valore predefinito è 5.

Se viene raggiunto il numero massimo di tentativi senza che il messaggio venga usato dall'applicazione, il messaggio viene inviato a una coda di tentativi per essere sottoposto in seguito a nuovi tentativi di elaborazione. Se non è specificato alcun ciclo di ripetizione, il messaggio viene inviato alla coda dei messaggi non elaborabili oppure viene inviato un riconoscimento negativo al mittente.
maxReceivedMessageSize Numero intero positivo che specifica la dimensione massima in byte dei messaggi, comprese le intestazioni. Il mittente di un messaggio riceve un errore SOAP se il messaggio è troppo grande per il destinatario. Il destinatario elimina il messaggio e crea una voce dell'evento nel registro di traccia. Il valore predefinito è 65536.
maxRetryCycles Numero intero che indica il numero massimo di cicli di ripetizione dei tentativi di recapito dei messaggi all'applicazione ricevente. Il valore predefinito è MaxValue.

Un singolo ciclo di ripetizione tenta di recapitare un messaggio a un'applicazione per un numero di volte specificato. Il numero di tentativi eseguiti è impostato dall'attributo maxImmediateRetries. Se l'applicazione non riesce a usare il messaggio dopo che i tentativi di recapito sono stati esauriti, il messaggio viene inviato a una coda di tentativi. I cicli di ripetizione successivi sono costituiti dal messaggio restituito dalla coda di tentativi alla coda dell'applicazione per tentare nuovamente il recapito all'applicazione, dopo un intervallo di tempo specificato dall'attributo retryCycleDelay. L'attributo maxRetryCycles specifica il numero di cicli di ripetizione che l'applicazione usa per tentare di recapitare il messaggio.
rejectAfterLastRetry Valore booleano che indica l'azione da intraprendere per un messaggio non recapitato dopo il numero massimo di tentativi.

true indica che al mittente viene restituito un non riconoscimento e che il messaggio viene eliminato. false indica che il messaggio viene inviato alla coda dei messaggi non elaborabili. Il valore predefinito è false.

Se il valore è false, l'applicazione ricevente può leggere la coda dei messaggi non elaborabili per elaborare i messaggi non elaborabili, ovvero i messaggi il cui recapito ha avuto esito negativo.

Poiché MSMQ 3.0 non supporta la restituzione di un non riconoscimento al mittente, questo attributo viene ignorato in MSMQ 3.0.
retryCycleDelay Valore TimeSpan che specifica l'intervallo di tempo tra i cicli di ripetizione dei tentativi di recapitare un messaggio che è impossibile recapitare immediatamente. L'impostazione predefinita è 00:10:00.

Un singolo ciclo di ripetizione tenta di recapitare un messaggio a un'applicazione ricevente per uno specificato numero di volte. Il numero di tentativi eseguiti è specificato dall'attributo maxImmediateRetries. Se l'applicazione non riesce a usare il messaggio dopo il numero specificato di tentativi immediati, il messaggio viene inviato a una coda di tentativi. I cicli di ripetizione successivi sono costituiti dal messaggio restituito dalla coda di tentativi alla coda dell'applicazione per tentare nuovamente il recapito all'applicazione, dopo un intervallo di tempo specificato dall'attributo retryCycleDelay. Il numero di cicli di ripetizione è specificato dall'attributo maxRetryCycles.
serializationFormat Specifica il formattatore usato per serializzare gli oggetti inviati come parte di un messaggio MSMQ. I valori validi sono:

- ActiveX: il formattatore ActiveX viene usato durante la serializzazione di oggetti COM.
- Binario: serializza l'oggetto in un pacchetto binario.
- ByteArray: serializza l'oggetto in una matrice di byte.
- Flusso: serializza l'oggetto in un flusso.
- Xml: serializza l'oggetto in un pacchetto XML. Il valore predefinito è XML.

L'attributo è di tipo MsmqMessageSerializationFormat.
timeToLive Valore TimeSpan che specifica la durata di validità dei messaggi prima che scadano e vengano inseriti nella coda dei messaggi non recapitabili. Il valore predefinito è 1.00:00:00, che corrisponde a un giorno.

L'attributo è impostato per verificare che i messaggi a scadenza non risultino non aggiornati prima di essere elaborati dalle applicazioni riceventi. Un messaggio in una coda che non viene usato dall'applicazione ricevente entro l'intervallo di tempo specificato viene considerato scaduto. I messaggi scaduti vengono inviati a una coda speciale denominata coda dei messaggi non recapitabili. Il percorso della coda dei messaggi non recapitabili viene impostato con l'attributo customDeadLetterQueue o sul valore appropriato predefinito, in base alle garanzie.
useMsmqTracing Valore booleano che specifica se i messaggi elaborati da questa associazione devono essere tracciati. Il valore predefinito è false.

Quando la traccia è attivata, i messaggi di rapporto vengono creati e inviati alla coda dei rapporti ogni volta che il messaggio viene inviato o ricevuto da un computer in cui è installato il sistema di accodamento messaggi.
useSourceJournal Valore booleano che indica se le copie dei messaggi elaborati da questa associazione devono essere archiviate nella coda journal di origine. Il valore predefinito è false.

Le applicazioni in coda che devono tenere un registro dei messaggi che hanno lasciato la coda in uscita del computer possono copiare i messaggi in una coda journal. Quando un messaggio lascia la coda in uscita e viene ricevuto un riconoscimento che il messaggio è stato ricevuto nel computer di destinazione, una copia del messaggio viene mantenuta nella coda journal del sistema del computer di invio.

Elementi figlio

Elemento Descrizione
sicurezzaTrasportoMsmq Specifica le impostazioni di sicurezza del trasporto per questa associazione. L'elemento è di tipo MsmqTransportSecurityElement.

Elementi padre

Elemento Descrizione
<Associazione> Definisce tutte le funzionalità di associazione dell'associazione personalizzata.

Vedi anche