MessageQueue.Authenticate Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Messaging

Zestaw:: System.Messaging.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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 Authenticate truewartość 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