MessageQueue.MulticastAddress Propriété

Définition

Espace de noms:

System.Messaging

Assembly:

System.Messaging.dll

Présentation dans MSMQ 3.0. Obtient ou définit l'adresse multicast associée à la file d'attente.

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

Valeur de propriété

String

String qui contient une adresse multicast valide (au format présenté ci-dessous) ou null, indiquant que la file d'attente n'est pas associée à une adresse multicast.

<address>:<port>

Attributs

MessagingDescriptionAttribute

Exceptions

PlatformNotSupportedException

MSMQ 3.0 n'est pas installé.

Remarques

La MulticastAddress propriété est utilisée pour associer une file d’attente non transactionnelle à une adresse de multidiffusion qui peut être utilisée lors de l’envoi de messages. Vous ne pouvez pas associer une file d’attente transactionnelle à une adresse de multidiffusion. Lorsque l’application d’envoi envoie des messages à une adresse de multidiffusion, Message Queuing envoie une copie du message à chaque file d’attente associée à cette adresse.

Les adresses de multidiffusion IP doivent se trouver dans la plage de classe D comprise entre 224.0.0.0 et 239.255.255.255, ce qui correspond à définir les quatre premiers bits d’ordre élevé égaux à 1110. Toutefois, seules certaines plages d’adresses de cette plage sont non réservées et disponibles pour l’envoi de messages de multidiffusion. Pour obtenir la liste la plus récente des adresses de multidiffusion réservées, consultez la page Web Adresses de multidiffusion Internet attribuées par Internet (IANA). Il n’existe aucune restriction sur le numéro de port.

Si plusieurs ordinateurs sources envoient des messages de multidiffusion et que vous souhaitez qu’une file d’attente spécifique reçoive des messages d’un seul ordinateur source, chaque ordinateur source doit envoyer des messages à une combinaison différente d’adresse IP et de numéro de port.

Pour dissocier une file d’attente d’une adresse de multidiffusion, définissez la MulticastAddress propriété sur une chaîne de longueur nulle. Ne le définissez pas sur null, car cela aboutira à un ArgumentNullException.

Le tableau suivant indique si cette propriété est disponible dans différents modes de groupe de travail.

Mode groupe de travail	Disponible
Ordinateur local	Oui
Ordinateur local et nom de format direct	Oui
Ordinateur distant	Non
Ordinateur distant et nom de format direct	Non