Udostępnij za pośrednictwem

MessageQueue.Authenticate Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Messaging
Zestaw:
System.Messaging.dll

Pobiera lub ustawia wartość wskazującą, czy kolejka akceptuje tylko uwierzytelnione komunikaty.

public:
 property bool Authenticate { bool get(); void set(bool value); };
[System.Messaging.MessagingDescription("MQ_Authenticate")]
public bool Authenticate { get; set; }
[<System.Messaging.MessagingDescription("MQ_Authenticate")>]
member this.Authenticate : bool with get, set
Public Property Authenticate As Boolean

Wartość właściwości

Boolean

true jeśli kolejka akceptuje tylko uwierzytelnione komunikaty; w przeciwnym razie , false. Wartość domyślna to false.

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 Authenticate .

// Set the queue's Authenticate property value.
queue.Authenticate = true;

// Display the new value of the queue's Authenticate property.
Console.WriteLine("MessageQueue.Authenticate: {0}", queue.Authenticate);

Uwagi

Uwierzytelnianie komunikatów umożliwia zapewnienie integralności komunikatów i sprawdzenie, kto wysłał wiadomość. Aby zażądać uwierzytelniania, aplikacja wysyłająca ustawia poziom uwierzytelniania komunikatu.

Po ustawieniu wartości na Authenticatetruewartość ograniczasz dostęp do kolejki na serwerze, nie tylko do tego MessageQueue wystąpienia. Dotyczy to wszystkich klientów pracujących z tą samą kolejką kolejkowania komunikatów.

Kolejka, która akceptuje tylko uwierzytelnione komunikaty, odrzuci komunikat nieuwierzytelnione. Aby zażądać powiadomienia o odrzuceniu wiadomości, aplikacja wysyłająca może ustawić AcknowledgeType właściwość komunikatu. Ponieważ nie istnieje żadne inne wskazanie odrzucenia komunikatu, aplikacja wysyłająca może utracić komunikat, chyba że zażądasz wysłania jej do kolejki utraconych komunikatów.

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

Dotyczy

Zobacz też