MessageQueue.EncryptionRequired Proprietà

Definizione

Ottiene o imposta un valore che indica se la coda accetta solo messaggi non privati (non crittografati).

public:
 property System::Messaging::EncryptionRequired EncryptionRequired { System::Messaging::EncryptionRequired get(); void set(System::Messaging::EncryptionRequired value); };
[System.Messaging.MessagingDescription("MQ_EncryptionRequired")]
public System.Messaging.EncryptionRequired EncryptionRequired { get; set; }
[<System.Messaging.MessagingDescription("MQ_EncryptionRequired")>]
member this.EncryptionRequired : System.Messaging.EncryptionRequired with get, set
Public Property EncryptionRequired As EncryptionRequired

Valore della proprietà

Uno dei valori di EncryptionRequired. Il valore predefinito è None.

Attributi

Eccezioni

Si è verificato un errore durante l'accesso a un metodo di Accodamento messaggi.

Esempio

L'esempio di codice seguente ottiene e imposta il valore della proprietà di una coda di EncryptionRequired messaggi.

// Set the queue's EncryptionRequired property value.
queue.EncryptionRequired = System.Messaging.EncryptionRequired.Optional;

// Display the new value of the queue's EncryptionRequired property.
Console.WriteLine("MessageQueue.EncryptionRequired: {0}",
    queue.EncryptionRequired);

Commenti

Quando si specifica che la crittografia è necessaria per i messaggi inviati a una coda, vengono crittografati solo i corpi dei messaggi. Gli altri membri (ad esempio, le Label proprietà e SenderId ) non possono essere crittografati.

L'impostazione di questa proprietà modifica la coda Accodamento messaggi. Pertanto, tutte le altre MessageQueue istanze sono interessate dalla modifica.

La crittografia di un messaggio rende il messaggio privato. È possibile specificare il requisito di crittografia della coda come None, Bodyo Optional impostando la EncryptionRequired proprietà in modo appropriato. L'impostazione UseEncryption del messaggio deve corrispondere al requisito di crittografia della coda. Se il messaggio non è crittografato, ma la coda specifica o se il messaggio viene crittografato, ma la coda specifica BodyNone, il messaggio viene rifiutato dalla coda. Se l'applicazione di invio richiede un messaggio di riconoscimento negativo in questo evento, Accodamento messaggi indica il rifiuto del messaggio all'applicazione di invio. Se la UseDeadLetterQueue proprietà è true, viene inviato un messaggio che ha esito negativo alla coda di messaggi non recapitabili. In caso contrario, il messaggio viene perso.

Nella tabella seguente viene illustrato se questa proprietà è disponibile in varie modalità gruppo di lavoro.

Modalità gruppo di lavoro Disponibile
Computer locale
Nome del computer locale e del formato diretto
Computer remoto No
Nome del formato diretto e del computer remoto No

Si applica a

Vedi anche