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 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 D de la classe 224.0.0.0 à 239.255.255.255, ce qui correspond à la définition des quatre premiers bits à ordre élevé égal à 1110. Toutefois, seules certaines plages d’adresses de cette plage ne sont pas réservées et disponibles pour l’envoi de messages multidiffusion. Pour obtenir la liste la plus récente des adresses de multidiffusion réservées, consultez la page Web Des 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 multidiffusion, définissez la MulticastAddress propriété sur une chaîne de longueur nulle. Ne définissez nullpas ce paramètre sur , car cela entraîne 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
Nom de l’ordinateur local et du format direct	Oui
Ordinateur distant	Non
Nom de l’ordinateur distant et du format direct	Non