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

Nell'esempio di codice seguente viene ottenuto e impostato il valore della EncryptionRequired proprietà di una coda di messaggi.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, le Label proprietà SenderId e) non possono essere crittografati.The other members (for example, the Label and SenderId properties) cannot be encrypted.

L'impostazione di questa proprietà consente di modificare la coda di Accodamento messaggi.Setting this property modifies the Message Queuing queue. Pertanto, tutte le MessageQueue altre istanze di sono interessate dalla modifica.Therefore, any other MessageQueue instances are affected by the change.

La crittografia di un messaggio rende privata il messaggio.Encrypting a message makes the message private. È possibile specificare che il requisito di crittografia della coda Nonesia Body, o Optional impostando la 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. L' UseEncryption impostazione del messaggio deve corrispondere al requisito 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 Bodyspecifica o se il messaggio è crittografato ma la coda Nonespecifica, il messaggio viene rifiutato 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 richiede un messaggio di riconoscimento negativo in questo evento, 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 la UseDeadLetterQueue proprietà è true, un messaggio che non riesce a crittografare viene inviato alla coda dei 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 viene perso.Otherwise, the message is lost.

Nella tabella seguente viene illustrato se questa proprietà è disponibile in varie modalità del 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
Nome del computer locale e del formato direttoLocal computer and direct format name Yes
Computer remotoRemote computer NoNo
Nome del computer remoto e del formato direttoRemote computer and direct format name NoNo

Si applica a

Vedi anche