MessageQueue.MulticastAddress Właściwość

Definicja

Wprowadzono w programie MSMQ 3.0. Pobiera lub ustawia adres multiemisji skojarzony z kolejką.

public:
 property System::String ^ MulticastAddress { System::String ^ get(); void set(System::String ^ value); };
[System.Messaging.MessagingDescription("MQ_MulticastAddress")]
public string MulticastAddress { get; set; }
[<System.Messaging.MessagingDescription("MQ_MulticastAddress")>]
member this.MulticastAddress : string with get, set
Public Property MulticastAddress As String

Wartość właściwości

Element String zawierający prawidłowy adres multiemisji (w formularzu przedstawionym poniżej) lub null, który wskazuje, że kolejka nie jest skojarzona z adresem multiemisji.

<address>:<port>
Atrybuty

Wyjątki

Program MSMQ 3.0 nie jest zainstalowany.

Uwagi

Właściwość MulticastAddress jest używana do skojarzenia kolejki innej niż transakcyjna z adresem multiemisji, który może być używany podczas wysyłania komunikatów. Nie można skojarzyć kolejki transakcyjnej z adresem multiemisji. Gdy aplikacja wysyłająca wysyła komunikaty na adres multiemisji, kolejkowanie komunikatów wysyła kopię komunikatu do każdej kolejki skojarzonej z tym adresem.

Adresy multiemisji IP muszą należeć do zakresu D klasy od 224.0.0.0 do 239.255.255.255, co odpowiada ustawieniu pierwszych czterech bitów o wysokiej kolejności równej 1110. Jednak tylko niektóre zakresy adresów w tym zakresie nie są zastrzeżone i dostępne do wysyłania komunikatów multiemisji. Aby uzyskać najnowszą listę zarezerwowanych adresów multiemisji, zobacz stronę sieci Web Internet Assigned Number Authority (IANA) Internet Multicast Addresses (IANA). Nie ma żadnych ograniczeń dotyczących numeru portu.

Jeśli kilka komputerów źródłowych wysyła komunikaty multiemisji i chcesz, aby określona kolejka odbierała komunikaty z tylko jednego komputera źródłowego, każdy komputer źródłowy musi wysyłać komunikaty do innej kombinacji adresu IP i numeru portu.

Aby usunąć skojarzenie kolejki z adresu multiemisji, ustaw MulticastAddress właściwość na ciąg o zerowej długości. Nie ustawiaj jej na nullwartość , ponieważ spowoduje to wyświetlenie elementu ArgumentNullException.

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
Komputer lokalny i nazwa formatu bezpośredniego Tak
Komputer zdalny Nie
Nazwa komputera zdalnego i formatu bezpośredniego Nie

Dotyczy