MessageQueue.MulticastAddress Właściwość

Definicja

Przestrzeń nazw:

System.Messaging

Zestaw:

System.Messaging.dll

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

String

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

<address>:<port>

Atrybuty

MessagingDescriptionAttribute

Wyjątki

PlatformNotSupportedException

Program MSMQ 3.0 nie jest zainstalowany.

Uwagi

Właściwość MulticastAddress służy do kojarzenia kolejki nie transakcyjnej 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 od 224.0.0.0 do 239.255.255.255, co odpowiada ustawieniu pierwszych czterech bitów o wysokiej kolejności równych 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). Numer portu nie ma żadnych ograniczeń.

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 należy ustawiać jej na nullwartość , ponieważ spowoduje to wyświetlenie wartości 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
Nazwa komputera lokalnego i bezpośredniego formatu	Tak
Komputer zdalny	Nie
Nazwa komputera zdalnego i bezpośredniego formatu	Nie