MessageQueue.EncryptionRequired Propiedad

Definición

Espacio de nombres:

System.Messaging

Ensamblado:

System.Messaging.dll

Obtiene o establece un valor que indica si la cola acepta únicamente mensajes no privados (no cifrados).

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

Valor de propiedad

EncryptionRequired

Uno de los valores de EncryptionRequired. De manera predeterminada, es None.

Atributos

MessagingDescriptionAttribute

Excepciones

MessageQueueException

Error al obtener acceso a un método de Message Queuing.

Ejemplos

En el ejemplo de código siguiente se obtiene y se establece el valor de la propiedad de una cola de EncryptionRequired mensajes.

// 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);

Comentarios

Cuando se especifica que se requiere cifrado para los mensajes enviados a una cola, solo se cifran los cuerpos del mensaje. Los demás miembros (por ejemplo, las Label propiedades y SenderId ) no se pueden cifrar.

Al establecer esta propiedad, se modifica la cola message Queuing. Por lo tanto, cualquier otra MessageQueue instancia se ve afectada por el cambio.

El cifrado de un mensaje hace que el mensaje sea privado. Puede especificar el requisito de cifrado de la cola para que sea None, Bodyo Optional estableciendo la EncryptionRequired propiedad correctamente. El UseEncryption valor del mensaje debe corresponder al requisito de cifrado de la cola. Si el mensaje no está cifrado, pero la cola especifica Body, o si el mensaje está cifrado, pero la cola especifica None, la cola rechaza el mensaje. Si la aplicación de envío solicita un mensaje de confirmación negativo en este evento, Message Queuing indica el rechazo del mensaje a la aplicación de envío. Si la UseDeadLetterQueue propiedad es true, se envía un mensaje que produce un error en el cifrado a la cola de mensajes fallidos. De lo contrario, se pierde el mensaje.

En la tabla siguiente se muestra si esta propiedad está disponible en varios modos de grupo de trabajo.

Modo de grupo de trabajo	Disponible
Equipo local	Sí
Equipo local y nombre de formato directo	Sí
Equipo remoto	No
Equipo remoto y nombre de formato directo	No

Consulte también

• Acknowledgment
• UseEncryption