MessageQueue.EncryptionRequired Właściwość

Definicja

Przestrzeń nazw:

System.Messaging

Zestaw:

System.Messaging.dll

Pobiera lub ustawia wartość wskazującą, czy kolejka akceptuje tylko komunikaty inne niż prywatne (niezaszyfrowane).

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

Wartość właściwości

EncryptionRequired

EncryptionRequired Jedna z wartości. Wartość domyślna to None.

Atrybuty

MessagingDescriptionAttribute

Wyjątki

MessageQueueException

Wystąpił błąd podczas uzyskiwania dostępu do metody kolejkowania komunikatów.

Przykłady

Poniższy przykład kodu pobiera i ustawia wartość właściwości kolejki komunikatów EncryptionRequired .

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

Uwagi

Po określeniu, że szyfrowanie jest wymagane dla komunikatów wysyłanych do kolejki, szyfrowane są tylko treści komunikatów. Nie można zaszyfrować innych elementów członkowskich (na przykład Label właściwości i SenderId ).

Ustawienie tej właściwości powoduje zmodyfikowanie kolejki kolejkowania komunikatów. W związku z tym zmiana ma wpływ na inne MessageQueue wystąpienia.

Szyfrowanie komunikatu powoduje, że wiadomość jest prywatna. Możesz określić wymaganie szyfrowania kolejki na Nonewartość , Bodylub Optional przez odpowiednie ustawienie EncryptionRequired właściwości. Ustawienie UseEncryption komunikatu musi odpowiadać wymaganiu szyfrowania kolejki. Jeśli komunikat nie jest zaszyfrowany, ale kolejka określa Body, lub jeśli komunikat jest zaszyfrowany, ale kolejka określa None, komunikat zostanie odrzucony przez kolejkę. Jeśli aplikacja wysyłająca żąda negatywnego komunikatu potwierdzenia w tym zdarzeniu, usługa kolejkowania komunikatów wskazuje odrzucenie komunikatu do aplikacji wysyłającej. UseDeadLetterQueue Jeśli właściwość to true, komunikat, który kończy się niepowodzeniem szyfrowania, jest wysyłany do kolejki utraconych komunikatów. W przeciwnym razie komunikat zostanie utracony.

W poniższej tabeli przedstawiono, czy ta właściwość jest dostępna w różnych trybach grupy roboczej.

Tryb grupy roboczej	Dostępne
Komputer lokalny	Tak
Nazwa komputera lokalnego i bezpośredniego formatu	Tak
Komputer zdalny	Nie
Nazwa komputera zdalnego i bezpośredniego formatu	Nie

Zobacz też

• Acknowledgment
• UseEncryption