Partilhar via


MessageQueue.EncryptionRequired Propriedade

Definição

Obtém ou define um valor que indica se a fila aceita apenas mensagens não privadas (não criptografadas).

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 da propriedade

Um dos valores de EncryptionRequired. O padrão é None.

Atributos

Exceções

Erro ao acessar um método do serviço de Enfileiramento de Mensagens.

Exemplos

O exemplo de código a seguir obtém e define o valor da propriedade de uma fila de EncryptionRequired mensagens.

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

Comentários

Quando você especifica que a criptografia é necessária para as mensagens enviadas para uma fila, somente os corpos de mensagem são criptografados. Os outros membros (por exemplo, as Label propriedades e SenderId ) não podem ser criptografados.

Definir essa propriedade modifica a fila de Enfileiramento de Mensagens. Portanto, quaisquer outras MessageQueue instâncias são afetadas pela alteração.

Criptografar uma mensagem torna a mensagem privada. Você pode especificar o requisito de criptografia da fila para ser None, Bodyou Optional definindo a EncryptionRequired propriedade adequadamente. A UseEncryption configuração da mensagem deve corresponder ao requisito de criptografia da fila. Se a mensagem não estiver criptografada, mas a fila especificar Bodyou se a mensagem for criptografada, mas a fila especificar None, a mensagem será rejeitada pela fila. Se o aplicativo de envio solicitar uma mensagem de confirmação negativa nesse evento, o Enfileiramento de Mensagens indicará a rejeição da mensagem ao aplicativo de envio. Se a UseDeadLetterQueue propriedade for true, uma mensagem que falha na criptografia será enviada para a fila de mensagens mortas. Caso contrário, a mensagem será perdida.

A tabela a seguir mostra se essa propriedade está disponível em vários modos de Grupo de Trabalho.

Modo de grupo de trabalho Disponível
Computador local Yes
Nome do computador local e do formato direto Yes
Computador remoto Não
Computador remoto e nome de formato direto Não

Aplica-se a

Confira também