MessageQueue.EncryptionRequired Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se a fila aceita apenas mensagens não privadas (não encriptadas).
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, setPublic Property EncryptionRequired As EncryptionRequiredValor de Propriedade
Um dos EncryptionRequired valores. A predefinição é None.
- Atributos
Exceções
Ocorreu um erro ao aceder a um método de Fila de Mensagens.
Exemplos
O seguinte exemplo de código obtém e define o valor da propriedade de EncryptionRequired uma fila de 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);
Observações
Quando especifica que a encriptação é necessária para as mensagens enviadas para uma fila, apenas os corpos das mensagens são encriptados. Os outros membros (por exemplo, as Label propriedades e) SenderId não podem ser encriptados.
Definir esta propriedade modifica a fila de Fila de Mensagens. Portanto, quaisquer outras MessageQueue instâncias são afetadas pela mudança.
Encriptar uma mensagem torna-a privada. Pode especificar que o requisito de encriptação da fila seja None, Body, ou Optional definindo a EncryptionRequired propriedade de forma adequada. A UseEncryption definição da mensagem deve corresponder ao requisito de encriptação da fila. Se a mensagem não estiver encriptada mas a fila especificar Body, ou se a mensagem for encriptada mas a fila especificar None, a mensagem é rejeitada pela fila. Se a aplicação de envio solicitar uma mensagem de confirmação negativa neste evento, a Fila de Mensagens indica a rejeição da mensagem para a aplicação enviante. Se a UseDeadLetterQueue propriedade for true, uma mensagem que falha na encriptação é enviada para a fila de letras mortas. Caso contrário, a mensagem perde-se.
A tabela seguinte mostra se esta propriedade está disponível em vários modos de Grupo de Trabalho.
| Modo de grupo de trabalho | Available |
|---|---|
| Computador local | Yes |
| Computador local e nome do formato direto | Yes |
| Computador remoto | No |
| Computador remoto e nome do formato direto | No |
