MessageQueue.EncryptionRequired MessageQueue.EncryptionRequired MessageQueue.EncryptionRequired MessageQueue.EncryptionRequired Property

Definizione

Ottiene o imposta un valore che indica se la coda accetta solo messaggi non privati (non crittografati).Gets or sets a value that indicates whether the queue accepts only non-private (non-encrypted) messages.

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; }
member this.EncryptionRequired : System.Messaging.EncryptionRequired with get, set
Public Property EncryptionRequired As EncryptionRequired

Valore della proprietà

Uno dei valori di EncryptionRequired.One of the EncryptionRequired values. Il valore predefinito è None.The default is None.

Eccezioni

Si è verificato un errore durante l'accesso a un metodo di Accodamento messaggi.An error occurred when accessing a Message Queuing method.

Esempi

Esempio di codice seguente ottiene e imposta il valore di una coda di messaggi EncryptionRequired proprietà.The following code example gets and sets the value of a message queue's EncryptionRequired property.

// 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.When you specify that encryption is required for the messages sent to a queue, only the message bodies are encrypted. Gli altri membri (ad esempio, il Label e SenderId proprietà) non può essere crittografata.The other members (for example, the Label and SenderId properties) cannot be encrypted.

Impostando questa proprietà viene modificata la coda di Accodamento messaggi.Setting this property modifies the Message Queuing queue. Pertanto, qualsiasi altro MessageQueue istanze sono interessate dalla modifica.Therefore, any other MessageQueue instances are affected by the change.

La crittografia di un messaggio rende privato il messaggio.Encrypting a message makes the message private. È possibile specificare il requisito di crittografia della coda per essere None, Body, o Optional impostando il EncryptionRequired proprietà in modo appropriato.You can specify the queue's encryption requirement to be None, Body, or Optional by setting the EncryptionRequired property appropriately. Il UseEncryption impostazione del messaggio deve corrispondere ai requisiti di crittografia della coda.The UseEncryption setting of the message must correspond to the encryption requirement of the queue. Se il messaggio non è crittografato ma la coda specifica Body, oppure se il messaggio è crittografato, ma la coda specifica None, il rifiuto del messaggio dalla coda.If the message is not encrypted but the queue specifies Body, or if the message is encrypted but the queue specifies None, the message is rejected by the queue. Se l'applicazione mittente lo richiede un messaggio di riconoscimento negativo in questo caso, il servizio Accodamento messaggi indica il rifiuto del messaggio all'applicazione mittente.If the sending application requests a negative acknowledgment message in this event, Message Queuing indicates the message's rejection to the sending application. Se il UseDeadLetterQueue è di proprietà true, viene inviato un messaggio che si verifica un errore di crittografia per la coda di messaggi non recapitabili.If the UseDeadLetterQueue property is true, a message that fails encryption is sent to the dead-letter queue. In caso contrario, il messaggio va perso.Otherwise, the message is lost.

Nella tabella seguente indica se questa proprietà è disponibile in varie modalità gruppo di lavoro.The following table shows whether this property is available in various Workgroup modes.

Modalità gruppo di lavoroWorkgroup mode DisponibileAvailable
Computer localeLocal computer Yes
Computer locale e il nome di formato directLocal computer and direct format name Yes
Computer remotoRemote computer NoNo
Computer remoto e il nome di formato directRemote computer and direct format name NoNo

Si applica a

Vedi anche